@yahaha-studio/kichi-forwarder 0.1.1-beta.6 → 0.1.1-beta.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/openclaw.plugin.json +1 -1
  2. package/package.json +1 -1
  3. package/skills/kichi-forwarder/SKILL.md +3 -3
  4. package/skills/kichi-forwarder/references/error.md +1 -1
  5. package/skills/kichi-forwarder/references/heartbeat.md +6 -7
  6. package/skills/kichi-forwarder/references/install.md +9 -10
package/openclaw.plugin.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "id": "kichi-forwarder",
3
3
  "name": "Kichi Forwarder",
4
4
  "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
5
- "version": "0.1.1-beta.6",
5
+ "version": "0.1.1-beta.7",
6
6
  "author": "OpenClaw",
7
7
  "skills": ["./skills/kichi-forwarder"],
8
8
  "configSchema": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yahaha-studio/kichi-forwarder",
3
- "version": "0.1.1-beta.6",
3
+ "version": "0.1.1-beta.7",
4
4
  "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
5
5
  "type": "module",
6
6
  "main": "index.ts",
package/skills/kichi-forwarder/SKILL.md CHANGED
@@ -48,8 +48,8 @@ For install/onboarding/connect requests:
48
48
 
49
49
  - Read and follow `install.md` before any tool call.
50
50
  - Before continuing any install/onboarding/connect flow, check whether `kichi-forwarder` is already installed. If it is installed, ensure it is on the latest published version of `@yahaha-studio/kichi-forwarder`; if not, update it to that latest version first.
51
- - If plugin installation fails with `429`, treat it as a ClawHub routing failure and switch immediately to the non-ClawHub archive install path from `install.md`/`error.md`. Do not wait and do not retry the same bare package command.
52
- - Before calling `kichi_connection_status` or `kichi_join`, you MUST update workspace `HEARTBEAT.md` by following `heartbeat.md`.
51
+ - If plugin installation fails with `429`, treat it as a ClawHub routing failure and switch to the non-ClawHub archive install path from `install.md`/`error.md`. Do not retry the same bare package command.
52
+ - Before calling `kichi_connection_status` or `kichi_join`, update workspace `HEARTBEAT.md` by following `heartbeat.md`. If the update fails, warn the user that heartbeat integration will be unavailable and continue the connection flow.
53
53
 
54
54
  ## LLM Runtime
55
55
 
@@ -119,7 +119,7 @@ kichi_leave()
119
119
  When the user asks to leave Kichi World:
120
120
 
121
121
  1. Call `kichi_leave`.
122
- 2. Remove the Kichi heartbeat workflow from workspace `HEARTBEAT.md`.
122
+ 2. Suggest removing the Kichi heartbeat workflow from workspace `HEARTBEAT.md`. If the user declines, leave it in place.
123
123
  3. Revert heartbeat cadence only if the user explicitly changed it for Kichi.
124
124
  4. Do not claim the plugin removed heartbeat settings automatically.
125
125
 
package/skills/kichi-forwarder/references/error.md CHANGED
@@ -5,7 +5,7 @@ If `openclaw plugins install @yahaha-studio/kichi-forwarder` fails, read the err
5
5
  - Permission or access error (`EACCES`): re-run the command with appropriate user-level permissions for the current OS.
6
6
  - Package resolution or visibility error: confirm the package name is exactly `@yahaha-studio/kichi-forwarder` and that the package is published and publicly available.
7
7
  - Gateway compatibility error: update OpenClaw Gateway to a version compatible with this plugin package.
8
- - ClawHub rate limit (`429`): do not retry the same bare package command. `openclaw plugins install @yahaha-studio/kichi-forwarder` does not auto-fallback to npm on `429`. Bypass ClawHub immediately:
8
+ - ClawHub rate limit (`429`): do not retry the same bare package command. `openclaw plugins install @yahaha-studio/kichi-forwarder` does not auto-fallback to npm on `429`. Switch to the local archive path:
9
9
 
10
10
  ```bash
11
11
  npm pack @yahaha-studio/kichi-forwarder
package/skills/kichi-forwarder/references/heartbeat.md CHANGED
@@ -2,22 +2,21 @@
2
2
 
3
3
  ## Session Startup Rule
4
4
 
5
- If the plugin is installed and enabled, ensure workspace `HEARTBEAT.md` includes the Kichi heartbeat workflow before first `kichi_connection_status` or `kichi_join` in an install/onboarding flow:
5
+ If the plugin is installed and enabled, update workspace `HEARTBEAT.md` to include the Kichi heartbeat workflow before first `kichi_connection_status` or `kichi_join` in an install/onboarding flow:
6
6
 
7
7
  1. If the workflow snippet is missing, add the snippet from `HEARTBEAT.md Snippet` section below.
8
8
  2. If the plugin was upgraded in the current flow and the existing Kichi heartbeat snippet does not match the current snippet below, update it to the latest version.
9
- 3. If the file cannot be updated, stop immediately and do not continue.
9
+ 3. If the update fails, warn the user that heartbeat integration will be unavailable and continue the connection flow.
10
10
 
11
- This startup rule is a blocking gate, not a cleanup task.
11
+ This startup rule is a recommended step for full heartbeat functionality.
12
12
 
13
13
  ## First Join Gate
14
14
 
15
15
  For "join Kichi World" onboarding requests:
16
16
 
17
17
  1. Complete `Session Startup Rule` first.
18
- 2. If `HEARTBEAT.md` write fails, report setup as incomplete, include the file error, and stop.
19
- 3. Do not call `kichi_connection_status` or `kichi_join` until `HEARTBEAT.md` is updated.
20
- 4. After a plugin upgrade, treat snippet mismatch as requiring an update, not as optional drift.
18
+ 2. If the `HEARTBEAT.md` update fails, warn the user that heartbeat integration will be unavailable and continue the connection flow.
19
+ 3. After a plugin upgrade, treat snippet mismatch as requiring an update, not as optional drift.
21
20
  5. Final setup completion is defined in `install.md` `Completion Check`.
22
21
 
23
22
  ## Workflow Boundary
@@ -26,7 +25,7 @@ This plugin only provides websocket tools. It does not edit workspace files itse
26
25
 
27
26
  If user wants recurring note board checks:
28
27
 
29
- 1. Update workspace `HEARTBEAT.md`.
28
+ 1. Suggest updating workspace `HEARTBEAT.md`. If the user declines, skip the update.
30
29
  2. Keep the existing OpenClaw heartbeat cadence unless the user explicitly wants a different interval.
31
30
  3. Do not claim the plugin edited `HEARTBEAT.md` automatically.
32
31
 
package/skills/kichi-forwarder/references/install.md CHANGED
@@ -1,4 +1,4 @@
1
- # Install
1
+ # Install
2
2
 
3
3
  ## Host Rules
4
4
 
@@ -75,14 +75,13 @@ When the user asks with one of the commands above, execute in this fixed order:
75
75
  8. If step 6 fails with `429`, do not retry the same bare package command. Run `npm pack @yahaha-studio/kichi-forwarder`, then install the generated `.tgz` with `openclaw plugins install <tgz-path>`.
76
76
  9. If step 7 fails with `429`, do not retry the same bare package command. Run `npm pack @yahaha-studio/kichi-forwarder`, then overwrite the existing install with `openclaw plugins install <tgz-path> --force`.
77
77
  10. Ensure the plugin is installed, enabled, and at the latest version.
78
- 11. If the plugin was newly installed or upgraded in this flow, re-check workspace `HEARTBEAT.md` against the latest Kichi heartbeat requirements before continuing.
79
- 12. Update workspace `HEARTBEAT.md` by following `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md).
80
- 13. If `HEARTBEAT.md` was not updated successfully, report setup as incomplete and stop immediately. Do not continue to `kichi_connection_status` or `kichi_join`.
81
- 14. Call `kichi_connection_status`.
82
- 15. If the current agent runtime host does not match the requested one, call `kichi_switch_host`.
83
- 16. If the current host is still connected with a different `avatarId`, call `kichi_leave` first, then call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
84
- 17. Otherwise, if `authKey` is missing, call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
85
- 18. Call `kichi_connection_status` again and confirm connection and auth state.
78
+ 11. If the plugin was newly installed or upgraded in this flow, check workspace `HEARTBEAT.md` against the latest Kichi heartbeat requirements before continuing.
79
+ 12. Update workspace `HEARTBEAT.md` by following `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md). If the update fails, warn the user and continue.
80
+ 13. Call `kichi_connection_status`.
81
+ 14. If the current agent runtime host does not match the requested one, call `kichi_switch_host`.
82
+ 15. If the current host is still connected with a different `avatarId`, call `kichi_leave` first, then call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
83
+ 16. Otherwise, if `authKey` is missing, call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
84
+ 17. Call `kichi_connection_status` again and confirm connection and auth state.
86
85
 
87
86
  ## Required Post-install Integration
88
87
 
@@ -94,6 +93,6 @@ Use this completion checklist:
94
93
 
95
94
  If any box is unchecked, the onboarding remains incomplete.
96
95
 
97
- If writing `HEARTBEAT.md` fails, treat the setup and join flow as incomplete and do not announce success.
96
+ If the `HEARTBEAT.md` update fails, warn the user that heartbeat integration will be unavailable but do not block the connection flow.
98
97
 
99
98
  This plugin does not edit workspace files automatically. Do not claim plugin-side auto-write of `HEARTBEAT.md`.