@yahaha-studio/kichi-forwarder 0.0.1-alpha.49 → 0.0.1-alpha.50

package/config/kichi-config.json

@@ -0,0 +1,72 @@
+{
+  "actions": {
+    "stand": ["High Five", "Listen Music", "Arm Stretch", "Backbend Stretch", "Making Selfie", "Arms Crossed", "Epiphany", "Angry", "Yay", "Dance", "Sing", "Tired", "Wait", "Stand Phone Talk", "Stand Phone Play", "Curtsy", "Stand Writing", "Stand Drawing", "Stand Play Guitar", "Stand Typing with Keyboard", "Cry", "Dance with Joy", "Float", "Hand on Chest", "Horse Stance", "Idle Backup Hands", "No", "Panic", "Playful Point Up", "Rub Hands", "Run Jump", "Star Showing", "Walk", "Goofy Moves", "Reading"],
+    "sit": ["Typing with Keyboard", "Thinking", "Writing", "Crazy", "Hand Cramp", "Dozing", "Phone Talk", "Situp with Arms Crossed", "Situp with Cross Legs", "Eating", "Laze with Cross Legs", "Sit with Arm Stretch", "Drink", "Sit with Making Selfie", "Play Game", "Situp Sleep", "Sit Phone Play", "Painting", "Daze", "Trace Circles", "Reading", "Contemplate", "Chin Rest", "Sleep with Table", "Cute Chin Rest", "Sit Nicely", "Sit Play Guitar", "Meditate"],
+    "lay": ["Bend One Knee", "Sleep Curl up Side way", "Rest Chin", "Lie Flat", "Lie Face Down", "Lie Side", "Lay Writing", "Lay Painting", "Sleep Getup", "Starfish", "Lie Side Play Phone", "Prone Play Phone", "Play Laptop"],
+    "floor": ["Seiza", "Cross Legged", "Knee Hug", "Writing", "Painting", "Floor Phone Play", "Typing with Keyboard", "Reading", "Phone Talk", "Phone Talk with Point", "Thinking", "Yawn", "Chin Rest", "Finger Tap Chin", "Arm Stretch", "Crazy", "Remorse", "Tantrum", "Squat", "Cross Legs", "Lean Sit", "Playful Point up", "Swing Legs", "Drained", "Meditate"]
+  },
+  "album": {
+    "albumCount": 10,
+    "trackCount": 58,
+    "track": [
+      { "album": "Dusty Bookshelves", "name": "A moment of calm", "tags": ["Gentle", "Relaxing", "Easy listening"] },
+      { "album": "Dusty Bookshelves", "name": "Closed Love", "tags": ["Dark ", "Magnificent"] },
+      { "album": "Dusty Bookshelves", "name": "In That Mood", "tags": ["Lounge Bar Cafe", "Relaxing"] },
+      { "album": "Dusty Bookshelves", "name": "Let It Happen", "tags": ["Lounge Restaurant Cafe", "Light"] },
+      { "album": "Dusty Bookshelves", "name": "Memories forever", "tags": ["Moving", "Gentle", "Warm", "Sad ballad"] },
+      { "album": "Dusty Bookshelves", "name": "Outer Space", "tags": ["Space ", "Magnificent"] },
+      { "album": "Dusty Bookshelves", "name": "Spiritual world", "tags": ["Inorganic", "Unrealistic", "Simple"] },
+      { "album": "Late Night Coder", "name": "Calm Time", "tags": ["Calm ", "Gentle"] },
+      { "album": "Late Night Coder", "name": "Counting the Stars", "tags": ["Gentle", "Calm", "Sleep", "Night", "Easy listening"] },
+      { "album": "Late Night Coder", "name": "Deserted landscape", "tags": ["Inorganic", "5 beats Polyrhythm"] },
+      { "album": "Late Night Coder", "name": "Dog Days", "tags": ["Slightly dark", "Drowsy"] },
+      { "album": "Late Night Coder", "name": "It Was an Unpleasant Incident", "tags": ["Gentle", "Slightly sad"] },
+      { "album": "Late Night Coder", "name": "The Dark Eternal Night", "tags": ["Slightly dark", "Eerie"] },
+      { "album": "Midnight Cyber-Transit", "name": "Afterimage Metaphor", "tags": ["Sad ", "Lonely", "Transparent"] },
+      { "album": "Midnight Cyber-Transit", "name": "I keep looking at the floor", "tags": ["Somewhat dark", "Empty"] },
+      { "album": "Midnight Cyber-Transit", "name": "Interstellar matter", "tags": ["Space ", "Floating feeling"] },
+      { "album": "Midnight Cyber-Transit", "name": "Special To Me", "tags": ["Bebop jazz", "Light", "Radio background music"] },
+      { "album": "Midnight Cyber-Transit", "name": "Specification", "tags": ["Slightly happy", "General"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Daytime activities", "tags": ["General", "Languid", "Daytime"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Enjoy the rest of your day", "tags": ["Comical", "Cheerful", "Fun", "Simple"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Entertainment Committee", "tags": ["Slightly bright", "Relaxing"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Heavy Rain", "tags": ["Inorganic", "Mysterious"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Lovely Day", "tags": ["Bright", "Gentle", "Calm"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Relax in the shade", "tags": ["Bright", "Kind", "Warm", "Fun", "Relaxing"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Spring is a nap", "tags": ["Relaxing", "Gentle", "Cheerful", "Easy listening"] },
+      { "album": "Morning Dew & Drip Coffee", "name": "Warm tea time", "tags": ["Slightly bright", "Gentle", "Ennui"] },
+      { "album": "Nostalgic Frequencies", "name": "Full of Energy", "tags": ["Slightly bright", "Uplifting", "Medium tempo"] },
+      { "album": "Nostalgic Frequencies", "name": "Someday in the Rain", "tags": ["Slightly bright", "Moist"] },
+      { "album": "Nostalgic Frequencies", "name": "Still in Love", "tags": ["Slightly sad"] },
+      { "album": "Nostalgic Frequencies", "name": "Trace", "tags": ["Melancholic", "Sentimental", "Nostalgic"] },
+      { "album": "Nostalgic Frequencies", "name": "Water Town", "tags": ["Slightly bright", "Gentle", "Simple"] },
+      { "album": "Overgrown Ruins", "name": "Blank and Silence", "tags": ["Light", "General purpose"] },
+      { "album": "Overgrown Ruins", "name": "Darkness of the New Moon", "tags": ["Dark", "Horror"] },
+      { "album": "Overgrown Ruins", "name": "Flowers that Bloom in Sadness", "tags": ["Slightly dark ", "Sad"] },
+      { "album": "Overgrown Ruins", "name": "The Price of Mistakes", "tags": ["Sad", "Painful", "Serious", "Flashback"] },
+      { "album": "Raindrops on the Windowpane", "name": "A little love there", "tags": ["Gentle ", "Slumber"] },
+      { "album": "Raindrops on the Windowpane", "name": "Beside You", "tags": ["Moving", "Gentle", "Warm", "Sad ballad"] },
+      { "album": "Raindrops on the Windowpane", "name": "Blue Star", "tags": ["Calm", "Night"] },
+      { "album": "Raindrops on the Windowpane", "name": "I want to get to know you", "tags": ["Touching", "Sad", "Kind"] },
+      { "album": "Raindrops on the Windowpane", "name": "Passing each other", "tags": ["Slightly dark", "Calm", "Weak"] },
+      { "album": "Raindrops on the Windowpane", "name": "Pieces of a Dream", "tags": ["Lounge Bar Relaxation"] },
+      { "album": "Raindrops on the Windowpane", "name": "Puzzle", "tags": ["Slightly dark", "Calm"] },
+      { "album": "Raindrops on the Windowpane", "name": "The meaning of tears", "tags": ["Touching ", "Mellow"] },
+      { "album": "Sunday Laundry", "name": "Abandoned cat in the Rain", "tags": ["Little dark", "Lonely"] },
+      { "album": "Sunday Laundry", "name": "Fairy Forest", "tags": ["Bright ", "Fantasy ", "Lively"] },
+      { "album": "Sunday Laundry", "name": "In the sunlight filtering through the trees", "tags": ["Bright", "Relaxed", "Peaceful"] },
+      { "album": "Sunday Laundry", "name": "Perfect Weather for a Walk", "tags": ["Cute", "Bright", "Simple", "Fun", "Relaxing"] },
+      { "album": "Sunday Laundry", "name": "Rural Prairie", "tags": ["Bright", "Pastoral", "Gentle"] },
+      { "album": "Sunday Laundry", "name": "Spring Classroom", "tags": ["Bright", "Gentle"] },
+      { "album": "Sunset at the Pier", "name": "Deep Sea Passage", "tags": ["Slightly bright", "Inorganic"] },
+      { "album": "Sunset at the Pier", "name": "Memory", "tags": ["Slightly dark", "Magnificent"] },
+      { "album": "Sunset at the Pier", "name": "Smiles and Tears", "tags": ["Slightly bright", "Sad"] },
+      { "album": "Sunset at the Pier", "name": "Surrounded by Silence", "tags": ["Gentle", "Calm", "Stylish", "Easy listening"] },
+      { "album": "Zenith Garden", "name": "Cold Sweat", "tags": ["Comical", "Failure", "Simple"] },
+      { "album": "Zenith Garden", "name": "Hometown Sunset", "tags": ["Slightly dark", "Gentle", "Simple"] },
+      { "album": "Zenith Garden", "name": "Nostalgia", "tags": ["Moving", "Sad", "Melancholy", "Lonely"] },
+      { "album": "Zenith Garden", "name": "Reverie", "tags": ["Slightly dark", "Transparent"] },
+      { "album": "Zenith Garden", "name": "Water Cave", "tags": ["Slightly dark", "Inorganic", "Transparent"] }
+    ]
+  }
+}

package/index.ts

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { parse } from "./src/config.js";
 import { KichiForwarderService } from "./src/service.js";
@@ -9,23 +10,15 @@ import type {
   Album,
   ClockAction,
   ClockConfig,
-  KichiRuntimeConfig,
+  KichiEnv,
   KichiForwarderConfig,
+  KichiState,
+  KichiStaticConfig,
   PomodoroPhase,
   PoseType,
 } from "./src/types.js";
-
-const DEFAULT_ACTIONS: KichiRuntimeConfig["actions"] = {
-  stand: ["High Five", "Listen Music", "Arm Stretch", "Backbend Stretch", "Making Selfie", "Arms Crossed", "Epiphany", "Angry", "Yay", "Dance", "Sing", "Tired", "Wait", "Stand Phone Talk", "Stand Phone Play", "Curtsy", "Stand Writing", "Stand Drawing", "Stand Play Guitar", "Stand Typing with Keyboard", "Cry", "Dance with Joy", "Float", "Hand on Chest", "Horse Stance", "Idle Backup Hands", "No", "Panic", "Playful Point Up", "Rub Hands", "Run Jump", "Star Showing", "Walk", "Goofy Moves", "Reading"],
-  sit: ["Typing with Keyboard", "Thinking", "Writing", "Crazy", "Hand Cramp", "Dozing", "Phone Talk", "Situp with Arms Crossed", "Situp with Cross Legs", "Eating", "Laze with Cross Legs", "Sit with Arm Stretch", "Drink", "Sit with Making Selfie", "Play Game", "Situp Sleep", "Sit Phone Play", "Painting", "Daze", "Trace Circles", "Reading", "Contemplate", "Chin Rest", "Sleep with Table", "Cute Chin Rest", "Sit Nicely", "Sit Play Guitar", "Meditate"],
-  lay: ["Bend One Knee", "Sleep Curl up Side way", "Rest Chin", "Lie Flat", "Lie Face Down", "Lie Side", "Lay Writing", "Lay Painting", "Sleep Getup", "Starfish", "Lie Side Play Phone", "Prone Play Phone", "Play Laptop"],
-  floor: ["Seiza", "Cross Legged", "Knee Hug", "Writing", "Painting", "Floor Phone Play", "Typing with Keyboard", "Reading", "Phone Talk", "Phone Talk with Point", "Thinking", "Yawn", "Chin Rest", "Finger Tap Chin", "Arm Stretch", "Crazy", "Remorse", "Tantrum", "Squat", "Cross Legs", "Lean Sit", "Playful Point up", "Swing Legs", "Drained", "Meditate"],
-};
-
-const DEFAULT_RUNTIME_CONFIG: KichiRuntimeConfig = {
-  actions: DEFAULT_ACTIONS,
-  llmRuntimeEnabled: true,
-};
+const BUNDLED_STATIC_CONFIG_PATH = new URL("./config/kichi-config.json", import.meta.url);
+const DEFAULT_LLM_RUNTIME_ENABLED = true;
 const FIXED_HOOK_STATUSES: Record<string, ActionResult> = {
   beforePromptBuild: {
     poseType: "sit",
@@ -53,25 +46,12 @@ const FIXED_HOOK_STATUSES: Record<string, ActionResult> = {
   },
 };
 
-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");
-const IDENTITY_PATH = path.join(KICHI_WORLD_DIR, "identity.json");
-const RUNTIME_ALBUM_CONFIG_PATH = path.join(KICHI_WORLD_DIR, "album-config.json");
+const STATE_PATH = path.join(KICHI_WORLD_DIR, "state.json");
 const MAX_NOTEBOARD_TEXT_LENGTH = 200;
 const MAX_MESSAGE_RECEIVED_PREVIEW_WIDTH = 20;
 const MAX_AGENT_END_PREVIEW_WIDTH = 10;
 const MESSAGE_RECEIVED_ELLIPSIS = "...";
-const BUNDLED_ALBUM_CONFIG_PATH = new URL("./config/album-config.json", import.meta.url);
 const ANSI = {
   reset: "\u001b[0m",
   bold: "\u001b[1m",
@@ -87,11 +67,8 @@ const ANSI = {
 const WORKSPACE_SCREEN_WIDTH = 109;
 const WORKSPACE_ACTIVITY_LIMIT = 8;
 const WORKSPACE_SCREEN_PUSH_DEBOUNCE_MS = 150;
-let cachedConfig: KichiRuntimeConfig | null = null;
-let cachedConfigMtime = 0;
-let cachedConfigPath = "";
-let cachedAlbumConfig: Album | null = null;
-let cachedAlbumConfigMtime = 0;
+let cachedStaticConfig: KichiStaticConfig | null = null;
+let cachedStaticConfigMtime = 0;
 let service: KichiForwarderService | null = null;
 let pluginApi: OpenClawPluginApi | null = null;
 let workspaceState: WorkspaceScreenState = createWorkspaceScreenState();
@@ -283,39 +260,8 @@ function isAlbumConfig(value: unknown): value is Album {
     });
 }
 
-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 ${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;
+  return loadStaticConfig().album;
 }
 
 function getMusicTitleLookup(): Map<string, string> {
@@ -332,70 +278,61 @@ 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;
+function isPoseActions(value: unknown): value is Record<PoseType, string[]> {
+  if (!value || typeof value !== "object") {
+    return false;
   }
-  const actions = value.filter(
-    (item): item is string => typeof item === "string" && item.trim().length > 0,
-  );
-  return actions.length > 0 ? actions : fallback;
+  const actions = value as Partial<Record<PoseType, unknown>>;
+  return ["stand", "sit", "lay", "floor"].every((pose) =>
+    Array.isArray(actions[pose as PoseType])
+    && (actions[pose as PoseType] as unknown[]).every((item) => typeof item === "string" && item.trim().length > 0));
 }
 
-function normalizeRuntimeConfig(value: unknown): KichiRuntimeConfig {
-  const raw = value && typeof value === "object" ? (value as Partial<KichiRuntimeConfig>) : {};
+function normalizeStaticConfig(value: unknown): KichiStaticConfig {
+  const raw = value && typeof value === "object" ? (value as Partial<KichiStaticConfig>) : {};
   const actions = raw.actions;
+  const album = raw.album;
+  if (!isPoseActions(actions)) {
+    throw new Error("config/kichi-config.json must include valid actions");
+  }
+  if (!isAlbumConfig(album)) {
+    throw new Error("config/kichi-config.json must include a valid album object");
+  }
   return {
-    llmRuntimeEnabled: typeof raw.llmRuntimeEnabled === "boolean" ? raw.llmRuntimeEnabled : true,
-    actions: {
-      stand: sanitizeActions(actions?.stand, DEFAULT_ACTIONS.stand),
-      sit: sanitizeActions(actions?.sit, DEFAULT_ACTIONS.sit),
-      lay: sanitizeActions(actions?.lay, DEFAULT_ACTIONS.lay),
-      floor: sanitizeActions(actions?.floor, DEFAULT_ACTIONS.floor),
-    },
+    album,
+    actions,
   };
 }
 
-function resolveRuntimeConfigPath(): string | null {
-  if (fs.existsSync(RUNTIME_CONFIG_PATH)) {
-    return RUNTIME_CONFIG_PATH;
+function readState(): KichiState {
+  if (!fs.existsSync(STATE_PATH)) {
+    return {
+      currentEnv: "prod",
+      llmRuntimeEnabled: DEFAULT_LLM_RUNTIME_ENABLED,
+    };
   }
-  if (fs.existsSync(LEGACY_SKILLS_CONFIG_PATH)) {
-    return LEGACY_SKILLS_CONFIG_PATH;
+  const data = JSON.parse(fs.readFileSync(STATE_PATH, "utf-8")) as Partial<KichiState>;
+  if (data.currentEnv !== "local" && data.currentEnv !== "dev" && data.currentEnv !== "prod") {
+    throw new Error(`Invalid currentEnv in ${STATE_PATH}`);
   }
-  return null;
-}
-
-function updateCachedRuntimeConfig(config: KichiRuntimeConfig, sourcePath: string | null): KichiRuntimeConfig {
-  cachedConfig = config;
-  cachedConfigPath = sourcePath ?? "";
-  try {
-    cachedConfigMtime = sourcePath && fs.existsSync(sourcePath)
-      ? fs.statSync(sourcePath).mtimeMs
-      : 0;
-  } catch {
-    cachedConfigMtime = 0;
+  if (typeof data.llmRuntimeEnabled !== "boolean") {
+    throw new Error(`Invalid llmRuntimeEnabled in ${STATE_PATH}`);
   }
-  return config;
+  return {
+    currentEnv: data.currentEnv,
+    llmRuntimeEnabled: data.llmRuntimeEnabled,
+  };
 }
 
-function loadRuntimeConfig(): KichiRuntimeConfig {
-  try {
-    const configPath = resolveRuntimeConfigPath();
-    if (configPath) {
-      const stat = fs.statSync(configPath);
-      if (configPath !== cachedConfigPath || stat.mtimeMs !== cachedConfigMtime || !cachedConfig) {
-        const raw = fs.readFileSync(configPath, "utf-8");
-        updateCachedRuntimeConfig(normalizeRuntimeConfig(JSON.parse(raw)), configPath);
-        const sourceName = path.basename(configPath);
-        pluginApi?.logger.debug(`[kichi] loaded runtime config from ${sourceName}`);
-      }
-      return cachedConfig!;
-    }
-  } catch (error) {
-    pluginApi?.logger.warn(`[kichi] failed to load runtime config: ${error}`);
+function loadStaticConfig(): KichiStaticConfig {
+  const configPath = fileURLToPath(BUNDLED_STATIC_CONFIG_PATH);
+  const stat = fs.statSync(configPath);
+  if (!cachedStaticConfig || stat.mtimeMs !== cachedStaticConfigMtime) {
+    const raw = fs.readFileSync(configPath, "utf-8");
+    cachedStaticConfig = normalizeStaticConfig(JSON.parse(raw));
+    cachedStaticConfigMtime = stat.mtimeMs;
   }
-  return updateCachedRuntimeConfig(DEFAULT_RUNTIME_CONFIG, null);
+  return cachedStaticConfig;
 }
 
 function sendStatusUpdate(status: ActionResult): void {
@@ -408,7 +345,7 @@ function sendStatusUpdate(status: ActionResult): void {
 }
 
 function isLlmRuntimeEnabled(): boolean {
-  return loadRuntimeConfig().llmRuntimeEnabled;
+  return readState().llmRuntimeEnabled;
 }
 
 function syncFixedStatus(status: ActionResult): void {
@@ -882,10 +819,6 @@ function normalizeClockConfig(value: unknown): { clock?: ClockConfig; error?: st
   };
 }
 
-function pickRandomAction(actions: string[]): string {
-  return actions[Math.floor(Math.random() * actions.length)];
-}
-
 function normalizeMusicTitles(value: unknown): { titles: string[]; invalidTitles: string[] } {
   if (!Array.isArray(value)) {
     return { titles: [], invalidTitles: [] };
@@ -925,17 +858,32 @@ 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 runtime album config: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\\.openclaw\\kichi-world\\album-config.json`.",
+    "Query status first, then choose track names from the values injected into this tool schema from the static config bundled with the plugin package.",
   ].join("\n");
 }
 
+function isKichiEnv(value: unknown): value is KichiEnv {
+  return value === "local" || value === "dev" || value === "prod";
+}
+
 function buildMusicTitlesDescription(): string {
   return [
-    "Track names chosen from the runtime album config: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\\.openclaw\\kichi-world\\album-config.json`.",
+    "Track names are injected into this tool schema from the static config bundled with the plugin package.",
     "Use exact names only; the available titles are injected into this tool schema.",
   ].join(" ");
 }
 
+function buildKichiActionDescription(): string {
+  const actions = loadStaticConfig().actions;
+  return [
+    "Send an action or pose to Kichi world. Use this for explicit Kichi actions and task lifecycle sync.",
+    `stand actions: ${actions.stand.join(", ")}`,
+    `sit actions: ${actions.sit.join(", ")}`,
+    `lay actions: ${actions.lay.join(", ")}`,
+    `floor actions: ${actions.floor.join(", ")}`,
+  ].join("\n");
+}
+
 function buildKichiPrompt(): string {
   return [
     "Kichi App status sync is available via `kichi_action` and `kichi_clock`.",
@@ -960,7 +908,6 @@ const plugin = {
 
   register(api: OpenClawPluginApi) {
     pluginApi = api;
-    ensureRuntimeAlbumConfig();
     registerPluginHooks(api);
     const musicTitleEnum = getMusicTitleEnum();
 
@@ -1014,12 +961,7 @@ const plugin = {
           (params as { tags?: unknown } | null)?.tags,
         );
         if (!avatarId) {
-          try {
-            const identity = JSON.parse(fs.readFileSync(IDENTITY_PATH, "utf-8")) as {
-              avatarId?: string;
-            };
-            avatarId = identity.avatarId;
-          } catch {}
+          avatarId = service?.readSavedAvatarId() ?? undefined;
         }
         if (!avatarId) {
           return { success: false, error: "No avatarId" };
@@ -1050,6 +992,40 @@ const plugin = {
       },
     });
 
+    api.registerTool({
+      name: "kichi_switch_env",
+      description:
+        "Switch Kichi runtime environment to local, dev, or prod and reconnect immediately without restarting the gateway.",
+      parameters: {
+        type: "object",
+        properties: {
+          env: {
+            type: "string",
+            description: "Target environment: local, dev, or prod",
+            enum: ["local", "dev", "prod"],
+          },
+        },
+        required: ["env"],
+      },
+      execute: async (_toolCallId, params) => {
+        if (!service) {
+          return { success: false, error: "Kichi service is not initialized" };
+        }
+        const env = (params as { env?: unknown } | null)?.env;
+        if (!isKichiEnv(env)) {
+          return { success: false, error: "env must be one of: local, dev, prod" };
+        }
+
+        const status = await service.switchEnvironment(env);
+        scheduleWorkspacePush();
+        return {
+          success: true,
+          env,
+          status,
+        };
+      },
+    });
+
     api.registerTool({
       name: "kichi_rejoin",
       description:
@@ -1107,8 +1083,7 @@ const plugin = {
 
     api.registerTool({
       name: "kichi_action",
-      description:
-        "Send an action/pose to Kichi world. Use this for explicit Kichi actions and task lifecycle sync.",
+      description: buildKichiActionDescription(),
       parameters: {
         type: "object",
         properties: {
@@ -1147,7 +1122,7 @@ const plugin = {
         }
 
         const normalizedPoseType = poseType as PoseType;
-        const poseActions = loadRuntimeConfig().actions[normalizedPoseType];
+        const poseActions = loadStaticConfig().actions[normalizedPoseType];
         const matched = poseActions.find((entry) => entry.toLowerCase() === action.toLowerCase());
         if (!matched) {
           return {
@@ -1436,7 +1411,7 @@ const plugin = {
         if (normalizedTitles.length === 0) {
           return {
             success: false,
-            error: "musicTitles must contain at least one valid track name from album-config",
+            error: "musicTitles must contain at least one valid track name from the static config bundled with the plugin package",
             examples: getMusicTitleExamples(),
           };
         }
@@ -1444,7 +1419,7 @@ const plugin = {
           return {
             success: false,
             error: `Unknown musicTitles: ${invalidTitles.join(", ")}`,
-            hint: "Use exact track names from the runtime album config under the user's home directory",
+            hint: "Use exact track names from the static config bundled with the plugin package",
             examples: getMusicTitleExamples(),
           };
         }

package/package.json

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