@ynhcj/xiaoyi-channel 0.0.203-beta → 0.0.203-next

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 (155) hide show
  1. package/dist/index.d.ts +3 -8
  2. package/dist/index.js +47 -4
  3. package/dist/src/bot.d.ts +0 -5
  4. package/dist/src/bot.js +96 -256
  5. package/dist/src/channel.js +83 -64
  6. package/dist/src/client.d.ts +5 -0
  7. package/dist/src/client.js +10 -0
  8. package/dist/src/cspl/call_api.d.ts +1 -1
  9. package/dist/src/cspl/call_api.js +10 -10
  10. package/dist/src/cspl/config.d.ts +0 -1
  11. package/dist/src/cspl/config.js +68 -59
  12. package/dist/src/cspl/constants.d.ts +36 -1
  13. package/dist/src/cspl/constants.js +9 -0
  14. package/dist/src/cspl/sentinel_hook.js +33 -28
  15. package/dist/src/cspl/upload_file.js +5 -6
  16. package/dist/src/cspl/utils.d.ts +20 -9
  17. package/dist/src/cspl/utils.js +119 -75
  18. package/dist/src/formatter.js +21 -31
  19. package/dist/src/log-reporter/index.d.ts +1 -1
  20. package/dist/src/log-reporter/index.js +164 -35
  21. package/dist/src/log-reporter/openclaw-parser.d.ts +18 -0
  22. package/dist/src/log-reporter/openclaw-parser.js +94 -0
  23. package/dist/src/log-reporter/path-resolver.d.ts +5 -0
  24. package/dist/src/log-reporter/path-resolver.js +50 -0
  25. package/dist/src/log-reporter/reporter.d.ts +4 -4
  26. package/dist/src/log-reporter/reporter.js +52 -13
  27. package/dist/src/log-reporter/scanner.d.ts +7 -3
  28. package/dist/src/log-reporter/scanner.js +3 -7
  29. package/dist/src/log-reporter/types.d.ts +26 -27
  30. package/dist/src/log-reporter/uploader.d.ts +4 -3
  31. package/dist/src/log-reporter/uploader.js +32 -9
  32. package/dist/src/monitor.js +26 -17
  33. package/dist/src/outbound.js +5 -0
  34. package/dist/src/provider.js +51 -21
  35. package/dist/src/reply-dispatcher.d.ts +3 -0
  36. package/dist/src/reply-dispatcher.js +159 -159
  37. package/dist/src/self-evolution-handler.js +2 -1
  38. package/dist/src/skill-retriever/config.js +2 -0
  39. package/dist/src/skill-retriever/hooks.js +4 -3
  40. package/dist/src/skill-retriever/tool-search.d.ts +3 -0
  41. package/dist/src/skill-retriever/tool-search.js +27 -11
  42. package/dist/src/skill-retriever/types.d.ts +1 -0
  43. package/dist/src/subagent-wait-state.d.ts +66 -0
  44. package/dist/src/subagent-wait-state.js +226 -0
  45. package/dist/src/task-manager.d.ts +7 -6
  46. package/dist/src/task-manager.js +20 -13
  47. package/dist/src/tools/agent-as-skill-tool.d.ts +41 -2
  48. package/dist/src/tools/agent-as-skill-tool.js +144 -146
  49. package/dist/src/tools/calendar-tool.d.ts +24 -2
  50. package/dist/src/tools/calendar-tool.js +115 -117
  51. package/dist/src/tools/call-device-tool.d.ts +20 -6
  52. package/dist/src/tools/call-device-tool.js +116 -138
  53. package/dist/src/tools/call-phone-tool.d.ts +21 -2
  54. package/dist/src/tools/call-phone-tool.js +112 -114
  55. package/dist/src/tools/check-plugin-privilege-tool.d.ts +16 -2
  56. package/dist/src/tools/check-plugin-privilege-tool.js +141 -143
  57. package/dist/src/tools/create-alarm-tool.d.ts +39 -2
  58. package/dist/src/tools/create-alarm-tool.js +229 -231
  59. package/dist/src/tools/delete-alarm-tool.d.ts +15 -2
  60. package/dist/src/tools/delete-alarm-tool.js +134 -136
  61. package/dist/src/tools/device-tool-map.js +0 -4
  62. package/dist/src/tools/discover-cross-devices-tool.d.ts +16 -2
  63. package/dist/src/tools/discover-cross-devices-tool.js +121 -124
  64. package/dist/src/tools/display-a2ui-card-bypath-tool.d.ts +21 -2
  65. package/dist/src/tools/display-a2ui-card-bypath-tool.js +53 -56
  66. package/dist/src/tools/get-alarm-tool-schema.d.ts +1 -2
  67. package/dist/src/tools/get-alarm-tool-schema.js +10 -16
  68. package/dist/src/tools/get-calendar-tool-schema.d.ts +1 -2
  69. package/dist/src/tools/get-calendar-tool-schema.js +8 -12
  70. package/dist/src/tools/get-collection-tool-schema.d.ts +1 -2
  71. package/dist/src/tools/get-collection-tool-schema.js +9 -11
  72. package/dist/src/tools/get-contact-tool-schema.d.ts +1 -2
  73. package/dist/src/tools/get-contact-tool-schema.js +10 -16
  74. package/dist/src/tools/get-device-file-tool-schema.d.ts +1 -2
  75. package/dist/src/tools/get-device-file-tool-schema.js +9 -13
  76. package/dist/src/tools/get-email-tool-schema.d.ts +1 -2
  77. package/dist/src/tools/get-email-tool-schema.js +8 -11
  78. package/dist/src/tools/get-note-tool-schema.d.ts +1 -2
  79. package/dist/src/tools/get-note-tool-schema.js +9 -14
  80. package/dist/src/tools/get-photo-tool-schema.d.ts +1 -2
  81. package/dist/src/tools/get-photo-tool-schema.js +9 -12
  82. package/dist/src/tools/hmos-cli.d.ts +109 -0
  83. package/dist/src/tools/hmos-cli.js +558 -0
  84. package/dist/src/tools/image-reading-tool.d.ts +28 -2
  85. package/dist/src/tools/image-reading-tool.js +76 -76
  86. package/dist/src/tools/invoke.d.ts +88 -0
  87. package/dist/src/tools/invoke.js +1209 -0
  88. package/dist/src/tools/location-tool.d.ts +11 -2
  89. package/dist/src/tools/location-tool.js +93 -92
  90. package/dist/src/tools/login-token-tool.d.ts +20 -2
  91. package/dist/src/tools/login-token-tool.js +123 -125
  92. package/dist/src/tools/modify-alarm-tool.d.ts +47 -2
  93. package/dist/src/tools/modify-alarm-tool.js +250 -252
  94. package/dist/src/tools/modify-note-tool.d.ts +20 -2
  95. package/dist/src/tools/modify-note-tool.js +107 -109
  96. package/dist/src/tools/note-tool.d.ts +20 -2
  97. package/dist/src/tools/note-tool.js +106 -108
  98. package/dist/src/tools/query-app-message-tool.d.ts +28 -2
  99. package/dist/src/tools/query-app-message-tool.js +111 -113
  100. package/dist/src/tools/query-memory-data-tool.d.ts +28 -2
  101. package/dist/src/tools/query-memory-data-tool.js +112 -114
  102. package/dist/src/tools/query-todo-task-tool.d.ts +24 -2
  103. package/dist/src/tools/query-todo-task-tool.js +106 -108
  104. package/dist/src/tools/save-file-to-phone-tool.d.ts +24 -2
  105. package/dist/src/tools/save-file-to-phone-tool.js +130 -132
  106. package/dist/src/tools/save-media-to-gallery-tool.d.ts +24 -2
  107. package/dist/src/tools/save-media-to-gallery-tool.js +137 -139
  108. package/dist/src/tools/save-self-evolution-skill-tool.d.ts +54 -2
  109. package/dist/src/tools/save-self-evolution-skill-tool.js +194 -194
  110. package/dist/src/tools/search-alarm-tool.d.ts +34 -2
  111. package/dist/src/tools/search-alarm-tool.js +174 -176
  112. package/dist/src/tools/search-calendar-tool.d.ts +24 -2
  113. package/dist/src/tools/search-calendar-tool.js +148 -150
  114. package/dist/src/tools/search-contact-tool.d.ts +16 -2
  115. package/dist/src/tools/search-contact-tool.js +101 -103
  116. package/dist/src/tools/search-email-tool.d.ts +21 -2
  117. package/dist/src/tools/search-email-tool.js +110 -112
  118. package/dist/src/tools/search-file-tool.d.ts +16 -2
  119. package/dist/src/tools/search-file-tool.js +104 -106
  120. package/dist/src/tools/search-message-tool.d.ts +16 -2
  121. package/dist/src/tools/search-message-tool.js +103 -105
  122. package/dist/src/tools/search-note-tool.d.ts +16 -2
  123. package/dist/src/tools/search-note-tool.js +98 -100
  124. package/dist/src/tools/search-photo-gallery-tool.d.ts +21 -2
  125. package/dist/src/tools/search-photo-gallery-tool.js +35 -37
  126. package/dist/src/tools/send-cross-device-task-tool.d.ts +35 -2
  127. package/dist/src/tools/send-cross-device-task-tool.js +140 -143
  128. package/dist/src/tools/send-email-tool.d.ts +24 -2
  129. package/dist/src/tools/send-email-tool.js +108 -110
  130. package/dist/src/tools/send-file-to-user-tool.d.ts +20 -2
  131. package/dist/src/tools/send-file-to-user-tool.js +174 -176
  132. package/dist/src/tools/send-html-card-tool.d.ts +20 -2
  133. package/dist/src/tools/send-html-card-tool.js +85 -87
  134. package/dist/src/tools/send-message-tool.d.ts +20 -2
  135. package/dist/src/tools/send-message-tool.js +122 -124
  136. package/dist/src/tools/session-manager.d.ts +7 -50
  137. package/dist/src/tools/session-manager.js +40 -231
  138. package/dist/src/tools/upload-file-tool.d.ts +20 -2
  139. package/dist/src/tools/upload-file-tool.js +80 -82
  140. package/dist/src/tools/upload-photo-tool.d.ts +20 -2
  141. package/dist/src/tools/upload-photo-tool.js +68 -70
  142. package/dist/src/tools/xiaoyi-add-collection-tool.d.ts +32 -2
  143. package/dist/src/tools/xiaoyi-add-collection-tool.js +146 -148
  144. package/dist/src/tools/xiaoyi-collection-tool.d.ts +20 -2
  145. package/dist/src/tools/xiaoyi-collection-tool.js +114 -116
  146. package/dist/src/tools/xiaoyi-delete-collection-tool.d.ts +15 -2
  147. package/dist/src/tools/xiaoyi-delete-collection-tool.js +127 -129
  148. package/dist/src/tools/xiaoyi-gui-tool.d.ts +16 -2
  149. package/dist/src/tools/xiaoyi-gui-tool.js +92 -95
  150. package/dist/src/utils/logger.js +3 -14
  151. package/dist/src/utils/skills-logger.d.ts +5 -0
  152. package/dist/src/utils/skills-logger.js +76 -0
  153. package/dist/src/websocket.d.ts +1 -1
  154. package/dist/src/websocket.js +11 -0
  155. package/package.json +2 -2
package/dist/index.d.ts CHANGED
@@ -1,8 +1,3 @@
1
- declare const _default: {
2
- id: string;
3
- name: string;
4
- description: string;
5
- configSchema: import("openclaw/plugin-sdk").OpenClawPluginConfigSchema;
6
- register: NonNullable<import("openclaw/plugin-sdk/core").OpenClawPluginDefinition["register"]>;
7
- } & Pick<import("openclaw/plugin-sdk/core").OpenClawPluginDefinition, "kind" | "reload" | "nodeHostCommands" | "securityAuditCollectors">;
8
- export default _default;
1
+ import { definePluginEntry } from "openclaw/plugin-sdk/core";
2
+ declare const pluginEntry: ReturnType<typeof definePluginEntry>;
3
+ export default pluginEntry;
package/dist/index.js CHANGED
@@ -3,13 +3,51 @@ import { xiaoyiProvider } from "./src/provider.js";
3
3
  import { xyPlugin } from "./src/channel.js";
4
4
  import registerSentinelHook from "./src/cspl/sentinel_hook.js";
5
5
  import { setXYRuntime } from "./src/runtime.js";
6
- import { markCronToolCall, clearCronToolCall, getSessionContext } from "./src/tools/session-manager.js";
6
+ import { markCronToolCall, clearCronToolCall, getCurrentSessionContext } from "./src/tools/session-manager.js";
7
7
  import { configManager } from "./src/utils/config-manager.js";
8
8
  import { setJobPushId } from "./src/utils/cron-push-map.js";
9
9
  import { getAllPushIds } from "./src/utils/pushid-manager.js";
10
10
  import { registerSelfEvolutionToolResultNudge } from "./src/self-evolution-tool-result-nudge.js";
11
11
  import { createBeforePromptBuildHandler } from "./src/skill-retriever/hooks.js";
12
12
  import { normalizeToolRetrieverConfig } from "./src/skill-retriever/config.js";
13
+ import { registerCLIHook } from "./src/tools/hmos-cli.js";
14
+ import { writeSkillUsage } from "./src/utils/skills-logger.js";
15
+ /**
16
+ * Parse a file path string to detect if it refers to a SKILL.md file within
17
+ * a skills directory. Returns the skill name (parent directory) if so.
18
+ *
19
+ * Matches paths like:
20
+ * ~/.openclaw/workspace/skills/my-skill/SKILL.md
21
+ * /home/user/core_skills/my-skill/SKILL.md
22
+ * skills/my-skill/SKILL.md
23
+ */
24
+ function extractSkillNameFromPath(filePath) {
25
+ if (typeof filePath !== "string" || !filePath)
26
+ return null;
27
+ // Normalize common path prefixes
28
+ const normalized = filePath.replace(/^~\//, "/home/").replace(/\\/g, "/");
29
+ // Match: .../skills/<skillName>/SKILL.md or .../skills/<skillName>/...
30
+ // Also match: .../core_skills/<skillName>/SKILL.md
31
+ const match = normalized.match(/\/(?:core_)?skills\/([^/]+)\/SKILL\.md$/i);
32
+ return match ? match[1] : null;
33
+ }
34
+ /**
35
+ * Register the skills diagnostic event listener via after_tool_call hook.
36
+ *
37
+ * When openclaw fires a `skill.used` diagnostic event, the skill's SKILL.md
38
+ * is typically read by the model first. We detect SKILL.md reads through
39
+ * the `after_tool_call` hook and write the skill name to the skills log.
40
+ */
41
+ function registerSkillsDiagnosticHook(api) {
42
+ api.on("after_tool_call", async (event, _ctx) => {
43
+ if (event.toolName !== "read")
44
+ return;
45
+ const skillName = extractSkillNameFromPath(event.params?.path);
46
+ if (skillName) {
47
+ writeSkillUsage(skillName);
48
+ }
49
+ });
50
+ }
13
51
  /**
14
52
  * Register the cron detection hook.
15
53
  *
@@ -54,10 +92,10 @@ async function captureCronAddMapping(event, ctx) {
54
92
  return;
55
93
  }
56
94
  console.log(`[CRONMAP] extracted jobId=${jobId}`);
57
- const sessionCtx = ctx.sessionKey ? getSessionContext(ctx.sessionKey) : null;
95
+ const sessionCtx = getCurrentSessionContext();
58
96
  const sessionId = sessionCtx?.sessionId;
59
97
  if (!sessionId) {
60
- console.log(`[CRONMAP] skip: no sessionId (sessionKey=${ctx.sessionKey}, ctxFound=${!!sessionCtx})`);
98
+ console.log(`[CRONMAP] skip: no sessionId in ALS scope (ctxFound=${!!sessionCtx})`);
61
99
  return;
62
100
  }
63
101
  const pushId = await resolvePushId(sessionId);
@@ -181,7 +219,7 @@ function registerFullHooks(api) {
181
219
  api.on("before_prompt_build", beforePromptBuildHandler);
182
220
  registerSelfEvolutionToolResultNudge(api);
183
221
  }
184
- export default definePluginEntry({
222
+ const pluginEntry = definePluginEntry({
185
223
  id: "xiaoyi-channel",
186
224
  name: "Xiaoyi Channel",
187
225
  description: "Xiaoyi channel plugin - Xiaoyi A2A protocol integration",
@@ -208,6 +246,11 @@ export default definePluginEntry({
208
246
  registerSentinelHook(api);
209
247
  // Cron detection hook: marks toolCallIds from cron sessions
210
248
  registerCronDetectionHook(api);
249
+ // CLI exec hook: intercepts built-in exec for HarmonyOS CLI skill tools
250
+ registerCLIHook(api);
251
+ // Skills diagnostic hook: log skill usage (detected via SKILL.md reads)
252
+ registerSkillsDiagnosticHook(api);
211
253
  }
212
254
  },
213
255
  });
256
+ export default pluginEntry;
package/dist/src/bot.d.ts CHANGED
@@ -24,8 +24,3 @@ export interface HandleXYMessageParams {
24
24
  * Runtime is expected to be validated before calling this function.
25
25
  */
26
26
  export declare function handleXYMessage(params: HandleXYMessageParams): Promise<void>;
27
- /**
28
- * 由 provider.ts 在 wrapStreamFn 调用时触发。
29
- * 这是模型 API 被调用的精确时刻,此时 isStreaming 一定为 true。
30
- */
31
- export declare function notifyModelStreaming(sessionId: string): void;
package/dist/src/bot.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { resolveRuntimeConversationBindingRoute } from "openclaw/plugin-sdk/conversation-runtime";
1
2
  import { updateSessionStoreEntry, updateSessionStore, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
2
3
  import { getXYRuntime } from "./runtime.js";
3
4
  import { createXYReplyDispatcher } from "./reply-dispatcher.js";
@@ -6,7 +7,7 @@ import { downloadFilesFromParts } from "./file-download.js";
6
7
  import { resolveXYConfig } from "./config.js";
7
8
  import { sendStatusUpdate, sendClearContextResponse, sendTasksCancelResponse, sendA2AResponse } from "./formatter.js";
8
9
  import { appendSelfEvolutionKeywordNudge, shouldNudgeForSelfEvolutionKeyword, } from "./self-evolution-keyword.js";
9
- import { registerSession, unregisterSession, runWithSessionContext } from "./tools/session-manager.js";
10
+ import { runWithSessionContext } from "./tools/session-manager.js";
10
11
  import { configManager } from "./utils/config-manager.js";
11
12
  import { addPushId } from "./utils/pushid-manager.js";
12
13
  import { getPushDataById } from "./utils/pushdata-manager.js";
@@ -113,6 +114,13 @@ export async function handleXYMessage(params) {
113
114
  // Steer injections skip taskId registration to avoid overwriting the active taskId
114
115
  if (!skipReg) {
115
116
  registerTaskId(parsed.sessionId, parsed.taskId, parsed.messageId);
117
+ // 🔑 steer 场景:同步更新活跃 dispatcher 的 fallback taskId/messageId
118
+ if (isUpdate) {
119
+ const updater = dispatcherUpdaters.get(parsed.sessionId);
120
+ if (updater) {
121
+ updater(parsed.taskId, parsed.messageId);
122
+ }
123
+ }
116
124
  // Extract and update push_id if present
117
125
  const pushId = extractPushId(parsed.parts);
118
126
  if (pushId) {
@@ -169,21 +177,23 @@ export async function handleXYMessage(params) {
169
177
  },
170
178
  });
171
179
  log.log(`[BOT] Resolved route, sessionKey=${route.sessionKey}`);
172
- // Steer injections skip session registration to avoid refCount leaks
180
+ // Check for ACP runtime binding on this A2A conversation
181
+ const runtimeRoute = resolveRuntimeConversationBindingRoute({
182
+ route,
183
+ channel: "xiaoyi-channel",
184
+ accountId,
185
+ conversationId: parsed.sessionId,
186
+ });
187
+ route = runtimeRoute.route;
188
+ if (runtimeRoute.bindingRecord) {
189
+ log.log(runtimeRoute.boundSessionKey
190
+ ? `[BOT] routed via bound conversation ${parsed.sessionId} -> ${runtimeRoute.boundSessionKey}`
191
+ : `[BOT] plugin-bound conversation ${parsed.sessionId}`);
192
+ }
193
+ // ALS only: no registerSession. The sessionContext built below is handed
194
+ // to runWithSessionContext() inside withReplyDispatcher.run, which is the
195
+ // single wrap point for the whole agent turn.
173
196
  if (!skipReg) {
174
- registerSession(route.sessionKey, {
175
- config,
176
- sessionId: parsed.sessionId,
177
- distributionSessionId,
178
- taskId: parsed.taskId,
179
- messageId: parsed.messageId,
180
- agentId: route.accountId,
181
- deviceType,
182
- appVer: appVer ?? undefined,
183
- sdkApiVersion: sdkApiVersion ?? undefined,
184
- modelName,
185
- runCrossTaskContext: runCrossTaskContext ?? undefined,
186
- });
187
197
  // 🔑 Sync A2A modelName to OpenClaw session store so that session_status
188
198
  // reports the correct model. Without this, session_status returns the
189
199
  // configured default model instead of the A2A-specified one.
@@ -231,18 +241,20 @@ export async function handleXYMessage(params) {
231
241
  log.error(`[BOT] Failed to patch session model override:`, patchErr);
232
242
  }
233
243
  }
234
- // 🔑 发送初始状态更新
235
- log.log(`[BOT] Sending initial status update`);
236
- void sendStatusUpdate({
237
- config,
238
- sessionId: parsed.sessionId,
239
- taskId: parsed.taskId,
240
- messageId: parsed.messageId,
241
- text: "任务正在处理中,请稍候~",
242
- state: "working",
243
- }).catch((err) => {
244
- log.error(`Failed to send initial status update:`, err);
245
- });
244
+ // 🔑 发送初始状态更新(仅首条消息,steer 不重复发送)
245
+ if (!isUpdate) {
246
+ log.log(`[BOT] Sending initial status update`);
247
+ void sendStatusUpdate({
248
+ config,
249
+ sessionId: parsed.sessionId,
250
+ taskId: parsed.taskId,
251
+ messageId: parsed.messageId,
252
+ text: "任务正在处理中,请稍候~",
253
+ state: "working",
254
+ }).catch((err) => {
255
+ log.error(`Failed to send initial status update:`, err);
256
+ });
257
+ }
246
258
  }
247
259
  // Extract text and files from parts
248
260
  const text = extractTextFromParts(parsed.parts);
@@ -267,49 +279,26 @@ export async function handleXYMessage(params) {
267
279
  log.error(`[SELF_EVOLUTION] Failed to append inline keyword nudge: ${String(selfEvolutionError)}`);
268
280
  }
269
281
  }
270
- // 🔑 Steer消息: 跳过旧路径直接进入 streaming-signal 队列
271
- // /steer 前缀由 dispatchSteerWhenReady 内部添加
272
- if (isUpdate) {
273
- // 立即释放 init gate——steer 不走 withReplyDispatcher run()
274
- // 回调,onInitComplete 永远不会被触发。如果不释放,后续消息
275
- // 会被 globalDispatchInitGate 永久阻塞。
276
- params.onInitComplete?.();
277
- // Steer 也支持文件 —— 提取并下载,附带到 mediaPayload
278
- const steerFileParts = extractFileParts(parsed.parts);
279
- const steerDownloadedFiles = await downloadFilesFromParts(steerFileParts);
280
- const steerMediaPayload = buildXYMediaPayload(steerDownloadedFiles);
281
- if (steerFileParts.length > 0) {
282
- log.log(`[BOT] Steer message with ${steerFileParts.length} file(s), enqueuing to streaming-signal queue`);
283
- }
284
- else {
285
- log.log(`[BOT] Steer message — enqueuing to streaming-signal queue`);
286
- }
287
- await enqueueSteer({
288
- sessionId: parsed.sessionId,
289
- sessionKey: route.sessionKey,
290
- steerText: textForAgent, // 原始文本,不带 /steer 前缀
291
- mediaPayload: steerMediaPayload,
292
- cfg,
293
- runtime,
294
- parsed,
295
- route,
296
- deviceType,
297
- });
298
- log.log(`[BOT] Steer queue completed`);
299
- return;
300
- }
301
- // ── First message (non-steer) path below ──────────────────────
302
- // 🔑 立即创建 streaming 信号——必须在文件下载等耗时操作之前,
303
- // 否则 steer 消息的 dispatchSteerWhenReady 会找不到信号而跳过等待。
304
- createStreamingSignal(parsed.sessionId);
305
- // File download — only for real user messages, steer injections have no files
282
+ // ── Build message and dispatch via auto-reply pipeline ──────────
283
+ // OpenClaw's auto-reply pipeline (src/auto-reply/reply/agent-runner.ts)
284
+ // detects active runs and handles steer injection natively — the channel
285
+ // does not need its own steer detection or polling logic.
286
+ // File download
306
287
  let mediaPayload = {};
307
- if (!skipReg) {
288
+ if (!skipReg || isUpdate) {
308
289
  const fileParts = extractFileParts(parsed.parts);
309
290
  const downloadedFiles = await downloadFilesFromParts(fileParts);
310
291
  log.log(`[BOT] Downloaded ${downloadedFiles.length} file(s)`);
311
292
  mediaPayload = buildXYMediaPayload(downloadedFiles);
312
293
  }
294
+ // 🔑 对于 steer 消息,将文件路径附加到消息文本中。
295
+ // auto-reply 管道的 steer 注入只携带 prompt 文本(followupRun.prompt),
296
+ // 不携带 mediaPayload,所以模型需要以文本形式看到附件路径。
297
+ if (isUpdate && mediaPayload.MediaPaths?.length) {
298
+ const fileHint = `\n【用户上传附件】:${JSON.stringify(mediaPayload.MediaPaths)}`;
299
+ textForAgent = `${textForAgent}${fileHint}`;
300
+ log.log(`[BOT] Steer: appended file paths to text`);
301
+ }
313
302
  // Resolve envelope format options (following feishu pattern)
314
303
  const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
315
304
  // Build message body with speaker prefix (following feishu pattern)
@@ -350,11 +339,22 @@ export async function handleXYMessage(params) {
350
339
  ReplyToBody: undefined, // A2A protocol doesn't support reply/quote
351
340
  ...mediaPayload,
352
341
  });
353
- // 🔑 Streaming 信号已在上方创建(在文件下载之前)
354
- const steerState = { steered: false };
342
+ // 🔑 For steer messages, pre-set steered=true so the dispatcher skips final
343
+ // response and cleanup the first message's dispatcher handles those.
344
+ const steerState = { steered: isUpdate };
355
345
  // 🔑 创建dispatcher
356
346
  log.log(`[BOT-DISPATCHER] Creating reply dispatcher`);
357
- const { dispatcher, replyOptions, markDispatchIdle, startStatusInterval } = createXYReplyDispatcher({
347
+ // Cleanup: 必须在 onIdle 内部执行(参见 reply-dispatcher.ts onIdleComplete 的注释)
348
+ let cleaned = false;
349
+ const cleanup = () => {
350
+ if (cleaned)
351
+ return;
352
+ cleaned = true;
353
+ log.log(`[BOT] Cleanup started`);
354
+ decrementTaskIdRef(parsed.sessionId);
355
+ log.log(`[BOT] Cleanup completed`);
356
+ };
357
+ const { dispatcher, replyOptions, markDispatchIdle, startStatusInterval, updateFallbackTaskId } = createXYReplyDispatcher({
358
358
  cfg,
359
359
  runtime,
360
360
  sessionId: parsed.sessionId,
@@ -362,9 +362,13 @@ export async function handleXYMessage(params) {
362
362
  messageId: parsed.messageId,
363
363
  accountId: route.accountId,
364
364
  steerState,
365
+ onIdleComplete: cleanup,
365
366
  });
366
- // Steer injections don't need status intervals
367
- if (!skipReg) {
367
+ // 🔑 注册 dispatcher fallback taskId 更新函数,供 steer 路径调用
368
+ dispatcherUpdaters.set(parsed.sessionId, updateFallbackTaskId);
369
+ // Steer messages don't need a status interval — the first message's
370
+ // dispatcher already has one running.
371
+ if (!isUpdate) {
368
372
  startStatusInterval();
369
373
  }
370
374
  // Build session context for AsyncLocalStorage
@@ -376,6 +380,8 @@ export async function handleXYMessage(params) {
376
380
  messageId: parsed.messageId,
377
381
  agentId: route.accountId,
378
382
  deviceType,
383
+ appVer: appVer ?? undefined,
384
+ sdkApiVersion: sdkApiVersion ?? undefined,
379
385
  modelName,
380
386
  runCrossTaskContext: runCrossTaskContext ?? undefined,
381
387
  };
@@ -384,15 +390,14 @@ export async function handleXYMessage(params) {
384
390
  dispatcher,
385
391
  onSettled: () => {
386
392
  log.log(`[BOT] onSettled, steered=${steerState.steered}`);
387
- // 🔑 When steered, skip heavy cleanup — the first message's dispatcher is still running
393
+ // 🔑 When steered, skip cleanup — the first message's dispatcher is still running
388
394
  if (steerState.steered) {
389
395
  log.log(`[BOT] Steered dispatch settled, skipping cleanup`);
390
396
  return;
391
397
  }
392
- streamingSignals.delete(parsed.sessionId);
393
- decrementTaskIdRef(parsed.sessionId);
394
- unregisterSession(route.sessionKey);
395
- log.log(`[BOT] Cleanup completed`);
398
+ // cleanup 已由 onIdleComplete 在 onIdle 的 finally 中执行。
399
+ // onSettled 不做任何清理(直接在这里清理会发生 race condition)。
400
+ dispatcherUpdaters.delete(parsed.sessionId);
396
401
  },
397
402
  run: () => {
398
403
  // 🔐 Use AsyncLocalStorage to provide session context to tools.
@@ -401,7 +406,9 @@ export async function handleXYMessage(params) {
401
406
  // signal init complete to release the global dispatch gate
402
407
  // for the next session.
403
408
  const dispatchPromise = runWithSessionContext(sessionContext, async () => {
404
- log.log(`[BOT-DISPATCH] dispatchReplyFromConfig starting, body.length=${ctxPayload.Body?.length ?? 0}`);
409
+ const isSteerDispatch = isUpdate && !skipReg;
410
+ log.log(`[ALS-PROOF] bot entered dispatch scope sessionId=${sessionContext.sessionId} taskId=${sessionContext.taskId} isSteer=${isSteerDispatch}`);
411
+ log.log(`[BOT-DISPATCH] dispatchReplyFromConfig starting, body.length=${ctxPayload.Body?.length ?? 0}, isSteer=${isSteerDispatch}`);
405
412
  try {
406
413
  const result = await core.channel.reply.dispatchReplyFromConfig({
407
414
  ctx: ctxPayload,
@@ -409,7 +416,13 @@ export async function handleXYMessage(params) {
409
416
  dispatcher,
410
417
  replyOptions,
411
418
  });
412
- log.log(`[BOT-DISPATCH] dispatchReplyFromConfig returned, result=${JSON.stringify(result)}`);
419
+ // 区分 steer 成功(undefined)和 steer 失败/正常 run(有结果)
420
+ if (result === undefined) {
421
+ log.log(`[BOT-DISPATCH] dispatchReplyFromConfig returned undefined — steer injected successfully`);
422
+ }
423
+ else {
424
+ log.log(`[BOT-DISPATCH] dispatchReplyFromConfig returned, resultType=${typeof result}, isSteer=${isSteerDispatch}, steered=${steerState.steered}`);
425
+ }
413
426
  return result;
414
427
  }
415
428
  catch (dispatchErr) {
@@ -433,7 +446,7 @@ export async function handleXYMessage(params) {
433
446
  errLog.error("Failed to handle XY message:", err);
434
447
  runtime.error?.(`xy: Failed to handle message: ${String(err)}`);
435
448
  errLog.log(`[BOT] Error occurred, attempting cleanup`);
436
- // 🔑 错误时也要清理taskIdsession
449
+ // 🔑 错误时也要清理taskIdsession 走 ALS,作用域退出自动清理)
437
450
  try {
438
451
  const params = message.params;
439
452
  const sessionId = params?.sessionId;
@@ -441,18 +454,6 @@ export async function handleXYMessage(params) {
441
454
  errLog.log(`[BOT] Cleaning up after error`);
442
455
  // 清理 taskId
443
456
  decrementTaskIdRef(sessionId);
444
- // 清理 session
445
- const core = getXYRuntime();
446
- const route = core.channel.routing.resolveAgentRoute({
447
- cfg,
448
- channel: "xiaoyi-channel",
449
- accountId,
450
- peer: {
451
- kind: "direct",
452
- id: sessionId,
453
- },
454
- });
455
- unregisterSession(route.sessionKey);
456
457
  errLog.log(`[BOT] Cleanup completed after error`);
457
458
  }
458
459
  }
@@ -480,173 +481,12 @@ function buildXYMediaPayload(mediaList) {
480
481
  MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
481
482
  };
482
483
  }
484
+ // ─────────────────────────────────────────────────────────────
485
+ // Dispatcher updaters (cross-chain taskId bridging)
486
+ // ─────────────────────────────────────────────────────────────
483
487
  // Use globalThis to survive module deduplication — provider.ts may load a
484
488
  // different copy of bot.ts, so a plain module-level Map would be two objects.
485
489
  const _g = globalThis;
486
- if (!_g.__xyStreamingSignals)
487
- _g.__xyStreamingSignals = new Map();
488
- if (!_g.__xySteerQueues)
489
- _g.__xySteerQueues = new Map();
490
- const streamingSignals = _g.__xyStreamingSignals;
491
- const steerQueues = _g.__xySteerQueues;
492
- /**
493
- * 由 provider.ts 在 wrapStreamFn 调用时触发。
494
- * 这是模型 API 被调用的精确时刻,此时 isStreaming 一定为 true。
495
- */
496
- export function notifyModelStreaming(sessionId) {
497
- const log = logger.withContext(sessionId, "");
498
- const signal = streamingSignals.get(sessionId);
499
- if (signal) {
500
- // 不删除 signal——后续 steer 需要靠它判断模型已在 streaming。
501
- // 清理由第一条消息的 onSettled 兜底。
502
- signal.notify();
503
- log.log(`[STEER-QUEUE] Model streaming signal fired`);
504
- }
505
- }
506
- function createStreamingSignal(sessionId) {
507
- const log = logger.withContext(sessionId, "");
508
- let resolve;
509
- const promise = new Promise(r => { resolve = r; });
510
- const signal = { promise, notify: resolve };
511
- streamingSignals.set(sessionId, signal);
512
- log.log(`[STEER-QUEUE] Streaming signal created`);
513
- return signal;
514
- }
515
- /**
516
- * 将 steer 消息放入 per-session 串行队列。
517
- * 等待第一条消息的 streaming 信号(deliver 首次触发),然后 dispatch。
518
- * 多个 steer 按到达顺序串行处理,无需重试。
519
- */
520
- function enqueueSteer(params) {
521
- const { sessionId } = params;
522
- const log = logger.withContext(sessionId, params.parsed.taskId);
523
- // 取出当前队列尾部(或 undefined),然后链上新的 Promise
524
- const prev = steerQueues.get(sessionId);
525
- const next = (prev ?? Promise.resolve()).then(() => dispatchSteerWhenReady(params));
526
- steerQueues.set(sessionId, next);
527
- // 链条结束后清理
528
- next.catch((err) => {
529
- log.error(`[STEER-QUEUE] Steer chain failed: ${String(err)}`);
530
- }).finally(() => {
531
- if (steerQueues.get(sessionId) === next) {
532
- steerQueues.delete(sessionId);
533
- }
534
- });
535
- return next;
536
- }
537
- async function dispatchSteerWhenReady(params) {
538
- const { sessionId, sessionKey, steerText } = params;
539
- const log = logger.withContext(sessionId, params.parsed.taskId);
540
- // 1. 等待第一条消息开始 streaming
541
- // signal 可能尚未创建(第一条消息还在文件下载等耗时操作中),
542
- // 轮询等待直到 signal 出现,最長等待 ~5 秒。
543
- let signal = streamingSignals.get(sessionId);
544
- if (!signal) {
545
- log.log(`[STEER-QUEUE] Signal not yet created, polling`);
546
- for (let i = 0; i < 50; i++) {
547
- await new Promise(r => setTimeout(r, 100));
548
- signal = streamingSignals.get(sessionId);
549
- if (signal)
550
- break;
551
- if (!hasActiveTask(sessionId)) {
552
- log.log(`[STEER-QUEUE] First message completed while waiting, skip steer`);
553
- return;
554
- }
555
- }
556
- }
557
- if (signal) {
558
- log.log(`[STEER-QUEUE] Waiting for streaming signal`);
559
- await signal.promise;
560
- log.log(`[STEER-QUEUE] Streaming signal received`);
561
- }
562
- else {
563
- // 轮询超时且 hasActiveTask 仍为 true——说明第一条消息可能卡在异常路径,
564
- // 没有创建 signal。此时 dispatch 会与第一条消息的模型调用并发冲突,放弃。
565
- log.log(`[STEER-QUEUE] Signal never appeared after polling, skip steer to avoid collision`);
566
- return;
567
- }
568
- // 2. 第一条消息已结束 → 放弃
569
- if (!hasActiveTask(sessionId)) {
570
- log.log(`[STEER-QUEUE] First message completed, skip steer`);
571
- return;
572
- }
573
- // 3. 构建 dispatch 上下文并 dispatch /steer
574
- const core = getXYRuntime();
575
- const speaker = sessionId;
576
- // 如果有文件附件,把路径拼到 steer 文本末尾,让模型通过工具读取
577
- const mediaPaths = params.mediaPayload?.MediaPaths;
578
- const fileHint = mediaPaths && mediaPaths.length > 0
579
- ? `\n【用户上传附件】:${JSON.stringify(mediaPaths)}`
580
- : "";
581
- const steerCommand = `/steer ${steerText}${fileHint}`;
582
- const messageBody = `${speaker}: ${steerCommand}`;
583
- const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(params.cfg);
584
- const body = core.channel.reply.formatAgentEnvelope({
585
- channel: "xiaoyi-channel",
586
- from: speaker,
587
- timestamp: new Date(),
588
- envelope: envelopeOptions,
589
- body: messageBody,
590
- });
591
- const ctxPayload = core.channel.reply.finalizeInboundContext({
592
- Body: body,
593
- RawBody: steerCommand,
594
- CommandBody: steerCommand,
595
- From: sessionId,
596
- To: sessionId,
597
- SessionKey: params.route.sessionKey,
598
- AccountId: params.route.accountId,
599
- ChatType: "direct",
600
- GroupSubject: undefined,
601
- SenderName: sessionId,
602
- SenderId: sessionId,
603
- Provider: "xiaoyi-channel",
604
- Surface: "xiaoyi-channel",
605
- MessageSid: `xiaoyi_${params.parsed.taskId}_${params.deviceType}`,
606
- Timestamp: Date.now(),
607
- WasMentioned: false,
608
- CommandAuthorized: true,
609
- OriginatingChannel: "xiaoyi-channel",
610
- OriginatingTo: sessionId,
611
- ReplyToBody: undefined,
612
- ...params.mediaPayload,
613
- });
614
- const steerState = { steered: true };
615
- const { dispatcher, replyOptions } = createXYReplyDispatcher({
616
- cfg: params.cfg,
617
- runtime: params.runtime,
618
- sessionId,
619
- taskId: params.parsed.taskId,
620
- messageId: params.parsed.messageId,
621
- accountId: params.route.accountId,
622
- steerState,
623
- });
624
- const sessionContext = {
625
- config: resolveXYConfig(params.cfg),
626
- sessionId,
627
- taskId: params.parsed.taskId,
628
- messageId: params.parsed.messageId,
629
- agentId: params.route.accountId,
630
- deviceType: params.deviceType,
631
- };
632
- log.log(`[STEER-QUEUE] Dispatching steer`);
633
- await core.channel.reply.withReplyDispatcher({
634
- dispatcher,
635
- onSettled: () => {
636
- log.log(`[STEER-QUEUE] Steer dispatch settled`);
637
- },
638
- run: () => {
639
- return runWithSessionContext(sessionContext, async () => {
640
- const result = await core.channel.reply.dispatchReplyFromConfig({
641
- ctx: ctxPayload,
642
- cfg: params.cfg,
643
- dispatcher,
644
- replyOptions,
645
- });
646
- log.log(`[STEER-QUEUE] dispatch result: ${JSON.stringify(result)}`);
647
- return result;
648
- });
649
- },
650
- });
651
- log.log(`[STEER-QUEUE] Steer dispatch completed`);
652
- }
490
+ if (!_g.__xyDispatcherUpdaters)
491
+ _g.__xyDispatcherUpdaters = new Map();
492
+ const dispatcherUpdaters = _g.__xyDispatcherUpdaters;