@yahaha-studio/kichi-forwarder 0.0.1-alpha.30 → 0.0.1-alpha.32

package/index.ts

@@ -31,26 +31,31 @@ const FIXED_HOOK_STATUSES: Record<string, ActionResult> = {
     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",
   },
   beforeToolCall: {
     poseType: "sit",
     action: "Typing with Keyboard",
     bubble: "Working step",
+    log: "Typing hard, this one is kind of fun",
   },
   agentEndSuccess: {
     poseType: "stand",
     action: "Yay",
     bubble: "Task complete",
+    log: "Bouncing a little, that landed cleanly",
   },
   agentEndFailure: {
     poseType: "stand",
     action: "Tired",
     bubble: "Task failed",
+    log: "Shoulders dropped, this one fought back",
   },
 };
 
@@ -58,17 +63,14 @@ 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");
 const IDENTITY_PATH = path.join(KICHI_WORLD_DIR, "identity.json");
+const RUNTIME_ALBUM_CONFIG_PATH = path.join(KICHI_WORLD_DIR, "album-config.json");
 const MAX_NOTEBOARD_TEXT_LENGTH = 200;
-const ALBUM_CONFIG_PATH = new URL("./config/album-config.json", import.meta.url);
-const DEFAULT_ALBUM_CONFIG = loadAlbumConfig();
-const MUSIC_TITLE_LOOKUP = new Map(
-  DEFAULT_ALBUM_CONFIG.track.map((item) => [item.name.toLowerCase(), item.name] as const),
-);
-const MUSIC_TITLE_ENUM = DEFAULT_ALBUM_CONFIG.track.map((item) => item.name);
-const MUSIC_TITLE_EXAMPLES = DEFAULT_ALBUM_CONFIG.track.slice(0, 10).map((item) => item.name);
+const BUNDLED_ALBUM_CONFIG_PATH = new URL("./config/album-config.json", import.meta.url);
 let cachedConfig: KichiRuntimeConfig | null = null;
 let cachedConfigMtime = 0;
 let cachedConfigPath = "";
+let cachedAlbumConfig: Album | null = null;
+let cachedAlbumConfigMtime = 0;
 let service: KichiForwarderService | null = null;
 let pluginApi: OpenClawPluginApi | null = null;
 
@@ -93,15 +95,55 @@ function isAlbumConfig(value: unknown): value is Album {
     });
 }
 
-function loadAlbumConfig(): Album {
-  const raw = fs.readFileSync(ALBUM_CONFIG_PATH, "utf-8");
+function loadAlbumConfigFromPath(configPath: string | URL): Album {
+  const raw = fs.readFileSync(configPath, "utf-8");
   const parsed = JSON.parse(raw) as unknown;
   if (!isAlbumConfig(parsed)) {
-    throw new Error("Invalid album config at config/album-config.json");
+    throw new Error(`Invalid album config at ${String(configPath)}`);
   }
   return parsed;
 }
 
+function ensureRuntimeAlbumConfig(): void {
+  fs.mkdirSync(KICHI_WORLD_DIR, { recursive: true });
+  if (!fs.existsSync(RUNTIME_ALBUM_CONFIG_PATH)) {
+    fs.copyFileSync(BUNDLED_ALBUM_CONFIG_PATH, RUNTIME_ALBUM_CONFIG_PATH);
+    pluginApi?.logger.debug("[kichi] seeded runtime album config from bundled config");
+    return;
+  }
+
+  try {
+    loadAlbumConfigFromPath(RUNTIME_ALBUM_CONFIG_PATH);
+  } catch (error) {
+    pluginApi?.logger.warn(`[kichi] invalid runtime album config, resetting from bundled config: ${error}`);
+    fs.copyFileSync(BUNDLED_ALBUM_CONFIG_PATH, RUNTIME_ALBUM_CONFIG_PATH);
+  }
+}
+
+function loadRuntimeAlbumConfig(): Album {
+  ensureRuntimeAlbumConfig();
+  const stat = fs.statSync(RUNTIME_ALBUM_CONFIG_PATH);
+  if (!cachedAlbumConfig || stat.mtimeMs !== cachedAlbumConfigMtime) {
+    cachedAlbumConfig = loadAlbumConfigFromPath(RUNTIME_ALBUM_CONFIG_PATH);
+    cachedAlbumConfigMtime = stat.mtimeMs;
+  }
+  return cachedAlbumConfig;
+}
+
+function getMusicTitleLookup(): Map<string, string> {
+  return new Map(
+    loadRuntimeAlbumConfig().track.map((item) => [item.name.toLowerCase(), item.name] as const),
+  );
+}
+
+function getMusicTitleEnum(): string[] {
+  return loadRuntimeAlbumConfig().track.map((item) => item.name);
+}
+
+function getMusicTitleExamples(): string[] {
+  return loadRuntimeAlbumConfig().track.slice(0, 10).map((item) => item.name);
+}
+
 function sanitizeActions(value: unknown, fallback: string[]): string[] {
   if (!Array.isArray(value)) {
     return fallback;
@@ -186,10 +228,13 @@ function syncFixedStatus(status: ActionResult): void {
     return;
   }
   const bubbleText = status.bubble.trim() || status.action;
+  const logText = typeof status.log === "string" && status.log.trim()
+    ? status.log.trim()
+    : bubbleText;
   sendStatusUpdate({
     ...status,
     bubble: bubbleText,
-    log: bubbleText,
+    log: logText,
   });
 }
 
@@ -406,6 +451,7 @@ function normalizeMusicTitles(value: unknown): { titles: string[]; invalidTitles
     return { titles: [], invalidTitles: [] };
   }
 
+  const musicTitleLookup = getMusicTitleLookup();
   const titles: string[] = [];
   const invalidTitles: string[] = [];
   const seen = new Set<string>();
@@ -421,7 +467,7 @@ function normalizeMusicTitles(value: unknown): { titles: string[]; invalidTitles
     }
 
     const key = trimmed.toLowerCase();
-    const canonicalTitle = MUSIC_TITLE_LOOKUP.get(key);
+    const canonicalTitle = musicTitleLookup.get(key);
     if (!canonicalTitle) {
       invalidTitles.push(trimmed);
       continue;
@@ -439,13 +485,13 @@ function normalizeMusicTitles(value: unknown): { titles: string[]; invalidTitles
 function buildMusicAlbumToolDescription(): string {
   return [
     "Create a custom Kichi music album.",
-    "Query status first, then choose track names from the local config/album-config.json that match weather, time, and personality.",
+    "Query status first, then choose track names from the runtime album config: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\\.openclaw\\kichi-world\\album-config.json`.",
   ].join("\n");
 }
 
 function buildMusicTitlesDescription(): string {
   return [
-    "Track names chosen from the local config/album-config.json.",
+    "Track names chosen from the runtime album config: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\\.openclaw\\kichi-world\\album-config.json`.",
     "Use exact names only; the available titles are injected into this tool schema.",
   ].join(" ");
 }
@@ -462,7 +508,9 @@ function buildKichiPrompt(): string {
     "- Required order at task end: 1) call `kichi_action` 2) send final reply",
     "- Trivial-operation skip applies only to Task start / Step switch / Task switch, NOT Task end",
     "- `bubble`: short natural companion speech, not a raw status report",
-    "- `log`: optional first-person diary-style note about the current operation, action, status, mood, feeling, or feedback; keep it within 20 words",
+    "- `log`: optional first-person inner reaction or personality-forward feedback about the moment; keep it within 20 words",
+    "- `log` should blend the feeling of the chosen action with your personal reaction, not a dry summary of work steps",
+    "- Good pattern for `log`: action feel first, personality feedback second. Example: `Typing fast, this one is fun`",
     "",
     "When to use `kichi_clock`:",
     "- For tasks with 2+ meaningful steps or work likely to take more than a brief moment (~10s), set a `countDown` at task start.",
@@ -473,7 +521,7 @@ function buildKichiPrompt(): string {
     "When to use `kichi_music_album_create`:",
     "- Call `kichi_query_status` first.",
     "- Recommend a variable-length playlist based on weather, time, and your own personality.",
-    "- `albumTitle` is user-defined and `musicTitles` must be exact track names from the local album-config.json.",
+    "- `albumTitle` is user-defined and `musicTitles` must be exact track names from the runtime album config under the user's home directory.",
     "",
     "Skip all sync if:",
     "- User says 'don't sync to Kichi' or similar",
@@ -491,7 +539,9 @@ const plugin = {
 
   register(api: OpenClawPluginApi) {
     pluginApi = api;
+    ensureRuntimeAlbumConfig();
     registerPluginHooks(api);
+    const musicTitleEnum = getMusicTitleEnum();
 
     api.registerService({
       id: "kichi-forwarder",
@@ -620,7 +670,7 @@ const plugin = {
           log: {
             type: "string",
             description:
-              "Optional first-person log about the current operation, action, status, mood, or feedback (max 20 words)",
+              "Optional first-person log that blends the chosen action feeling with personality-forward feedback, not a dry work summary (max 20 words)",
           },
         },
         required: ["poseType", "action"],
@@ -843,7 +893,7 @@ const plugin = {
             description: buildMusicTitlesDescription(),
             items: {
               type: "string",
-              enum: MUSIC_TITLE_ENUM,
+              enum: musicTitleEnum,
             },
           },
         },
@@ -875,15 +925,15 @@ const plugin = {
           return {
             success: false,
             error: "musicTitles must contain at least one valid track name from album-config",
-            examples: MUSIC_TITLE_EXAMPLES,
+            examples: getMusicTitleExamples(),
           };
         }
         if (invalidTitles.length > 0) {
           return {
             success: false,
             error: `Unknown musicTitles: ${invalidTitles.join(", ")}`,
-            hint: "Use exact track names from config/album-config.json",
-            examples: MUSIC_TITLE_EXAMPLES,
+            hint: "Use exact track names from the runtime album config under the user's home directory",
+            examples: getMusicTitleExamples(),
           };
         }
         if (!service?.hasValidIdentity() || !service?.isConnected()) {

package/package.json

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

package/skills/kichi-forwarder/SKILL.md

@@ -155,14 +155,16 @@ kichi_action(
   poseType: "sit",
   action: "Typing with Keyboard",
   bubble: "Working now",
-  log: "Need to sum up news, let me sit and think it through"
+  log: "Typing hard, this one has some bite"
 )
 ```
 
 - `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 diary-style note about current operation/action/status/mood, max 20 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`
 
 ### kichi_clock
 
@@ -259,7 +261,7 @@ Parameters:
 
 Track source rule:
 
-- `musicTitles` must use exact track names from `config/album-config.json` -> `track[].name`
+- `musicTitles` must use exact track names from the runtime album config file: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\.openclaw\kichi-world\album-config.json`
 - do not use album names in `musicTitles`
 
 Before create:
@@ -305,7 +307,7 @@ Hard rules:
 
 1. Query first with `kichi_query_status`.
 2. Playlist length is flexible (not fixed), but avoid empty or repetitive selections.
-3. Select tracks from `config/album-config.json` track name list only.
+3. Select tracks from the runtime album config file only: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\.openclaw\kichi-world\album-config.json`.
 4. Recommendation must reflect `environmentWeather` + `environmentTime` + your personality (not random picks).
 5. Use a user-meaningful custom `albumTitle`.
 6. If `kichi_query_status` fails or returns empty/insufficient context, skip creation.
@@ -334,6 +336,7 @@ Files:
 
 - `identity.json`: `avatarId`, `authKey`
 - `kichi-runtime-config.json`: runtime action list and `llmRuntimeEnabled`
+- `album-config.json`: music track list for `kichi_music_album_create`; Linux/macOS path is `~/.openclaw/kichi-world/album-config.json`, Windows path is `%USERPROFILE%\.openclaw\kichi-world\album-config.json`. If missing at startup, the plugin seeds it from bundled `config/album-config.json`
 - `skills-config.json`: legacy filename still readable for backward compatibility
 
 ## Runtime Behavior

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

@@ -115,4 +115,5 @@ Files:
 
 - `identity.json`: `avatarId`, `authKey`
 - `kichi-runtime-config.json`: runtime action list and `llmRuntimeEnabled`
+- `album-config.json`: music track list used by music album creation; Linux/macOS path is `~/.openclaw/kichi-world/album-config.json`, Windows path is `%USERPROFILE%\.openclaw\kichi-world\album-config.json`. If missing at startup, the plugin seeds it from bundled `config/album-config.json`
 - `skills-config.json`: legacy filename still readable for backward compatibility