@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

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 (344) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +43 -30
  3. package/dist/src/approval-policy.d.ts +11 -2
  4. package/dist/src/approval-policy.js +33 -7
  5. package/dist/src/approval-policy.js.map +1 -1
  6. package/dist/src/callback-cli-adapter.d.ts +47 -0
  7. package/dist/src/callback-cli-adapter.js +156 -0
  8. package/dist/src/callback-cli-adapter.js.map +1 -0
  9. package/dist/src/callback-outbox-policy.d.ts +95 -0
  10. package/dist/src/callback-outbox-policy.js +149 -0
  11. package/dist/src/callback-outbox-policy.js.map +1 -0
  12. package/dist/src/callback-outbox-service.d.ts +247 -0
  13. package/dist/src/callback-outbox-service.js +1053 -0
  14. package/dist/src/callback-outbox-service.js.map +1 -0
  15. package/dist/src/callback-outbox-settlement.d.ts +54 -0
  16. package/dist/src/callback-outbox-settlement.js +241 -0
  17. package/dist/src/callback-outbox-settlement.js.map +1 -0
  18. package/dist/src/canonical-json.d.ts +1 -0
  19. package/dist/src/canonical-json.js +14 -0
  20. package/dist/src/canonical-json.js.map +1 -0
  21. package/dist/src/claude-lifecycle-compatibility.js +15 -0
  22. package/dist/src/claude-lifecycle-compatibility.js.map +1 -1
  23. package/dist/src/claude-local-transcript-provider.d.ts +82 -1
  24. package/dist/src/claude-local-transcript-provider.js +873 -23
  25. package/dist/src/claude-local-transcript-provider.js.map +1 -1
  26. package/dist/src/cli-command-runtime.d.ts +14 -0
  27. package/dist/src/cli-command-runtime.js +164 -0
  28. package/dist/src/cli-command-runtime.js.map +1 -0
  29. package/dist/src/cli-core.d.ts +4 -42
  30. package/dist/src/cli-core.js +958 -28684
  31. package/dist/src/cli-core.js.map +1 -1
  32. package/dist/src/cli-runtime-context.d.ts +57 -0
  33. package/dist/src/cli-runtime-context.js +118 -0
  34. package/dist/src/cli-runtime-context.js.map +1 -0
  35. package/dist/src/codex-lifecycle-compatibility.js +2 -1
  36. package/dist/src/codex-lifecycle-compatibility.js.map +1 -1
  37. package/dist/src/codex-local-session-provider.d.ts +18 -0
  38. package/dist/src/codex-local-session-provider.js +67 -0
  39. package/dist/src/codex-local-session-provider.js.map +1 -1
  40. package/dist/src/codex-session-provider.js +1 -3
  41. package/dist/src/codex-session-provider.js.map +1 -1
  42. package/dist/src/conversation-trace.d.ts +30 -0
  43. package/dist/src/conversation-trace.js +185 -0
  44. package/dist/src/conversation-trace.js.map +1 -0
  45. package/dist/src/deferred-foreground-application-service.d.ts +84 -0
  46. package/dist/src/deferred-foreground-application-service.js +742 -0
  47. package/dist/src/deferred-foreground-application-service.js.map +1 -0
  48. package/dist/src/deferred-foreground-authority-cli-adapter.d.ts +78 -0
  49. package/dist/src/deferred-foreground-authority-cli-adapter.js +795 -0
  50. package/dist/src/deferred-foreground-authority-cli-adapter.js.map +1 -0
  51. package/dist/src/deferred-foreground-boundary.d.ts +61 -0
  52. package/dist/src/deferred-foreground-boundary.js +2 -0
  53. package/dist/src/deferred-foreground-boundary.js.map +1 -0
  54. package/dist/src/deferred-foreground-capability.d.ts +4 -0
  55. package/dist/src/deferred-foreground-capability.js +184 -0
  56. package/dist/src/deferred-foreground-capability.js.map +1 -0
  57. package/dist/src/deferred-foreground-preparation-cli-adapter.d.ts +53 -0
  58. package/dist/src/deferred-foreground-preparation-cli-adapter.js +210 -0
  59. package/dist/src/deferred-foreground-preparation-cli-adapter.js.map +1 -0
  60. package/dist/src/deferred-foreground-preparation-service.d.ts +72 -0
  61. package/dist/src/deferred-foreground-preparation-service.js +179 -0
  62. package/dist/src/deferred-foreground-preparation-service.js.map +1 -0
  63. package/dist/src/deferred-foreground-recovery-cli-adapter.d.ts +139 -0
  64. package/dist/src/deferred-foreground-recovery-cli-adapter.js +1125 -0
  65. package/dist/src/deferred-foreground-recovery-cli-adapter.js.map +1 -0
  66. package/dist/src/deferred-foreground-recovery-service.d.ts +48 -0
  67. package/dist/src/deferred-foreground-recovery-service.js +91 -0
  68. package/dist/src/deferred-foreground-recovery-service.js.map +1 -0
  69. package/dist/src/deferred-foreground-transfer-policy.d.ts +2 -0
  70. package/dist/src/deferred-foreground-transfer-policy.js +10 -0
  71. package/dist/src/deferred-foreground-transfer-policy.js.map +1 -0
  72. package/dist/src/deferred-foreground-transfer.js +46 -105
  73. package/dist/src/deferred-foreground-transfer.js.map +1 -1
  74. package/dist/src/doctor-capabilities.d.ts +9 -0
  75. package/dist/src/doctor-capabilities.js +22 -0
  76. package/dist/src/doctor-capabilities.js.map +1 -1
  77. package/dist/src/durable-json-file.d.ts +22 -0
  78. package/dist/src/durable-json-file.js +127 -0
  79. package/dist/src/durable-json-file.js.map +1 -0
  80. package/dist/src/file-lock-cli-adapter.d.ts +43 -0
  81. package/dist/src/file-lock-cli-adapter.js +150 -0
  82. package/dist/src/file-lock-cli-adapter.js.map +1 -0
  83. package/dist/src/herdr-terminal-control-provider.js +1 -3
  84. package/dist/src/herdr-terminal-control-provider.js.map +1 -1
  85. package/dist/src/install-doctor-command-adapter.d.ts +17 -0
  86. package/dist/src/install-doctor-command-adapter.js +225 -0
  87. package/dist/src/install-doctor-command-adapter.js.map +1 -0
  88. package/dist/src/live-lifecycle-evidence.js +76 -46
  89. package/dist/src/live-lifecycle-evidence.js.map +1 -1
  90. package/dist/src/live-lifecycle-smoke.js +74 -50
  91. package/dist/src/live-lifecycle-smoke.js.map +1 -1
  92. package/dist/src/managed-session.d.ts +2 -0
  93. package/dist/src/managed-session.js +24 -0
  94. package/dist/src/managed-session.js.map +1 -1
  95. package/dist/src/managed-turn-recovery-service.d.ts +86 -0
  96. package/dist/src/managed-turn-recovery-service.js +145 -0
  97. package/dist/src/managed-turn-recovery-service.js.map +1 -0
  98. package/dist/src/mutation-transaction.d.ts +48 -0
  99. package/dist/src/mutation-transaction.js +73 -0
  100. package/dist/src/mutation-transaction.js.map +1 -0
  101. package/dist/src/native-thread-lifecycle-cli-adapter.d.ts +154 -0
  102. package/dist/src/native-thread-lifecycle-cli-adapter.js +786 -0
  103. package/dist/src/native-thread-lifecycle-cli-adapter.js.map +1 -0
  104. package/dist/src/native-thread-lifecycle-ledger-cli-adapter.d.ts +25 -0
  105. package/dist/src/native-thread-lifecycle-ledger-cli-adapter.js +50 -0
  106. package/dist/src/native-thread-lifecycle-ledger-cli-adapter.js.map +1 -0
  107. package/dist/src/native-thread-lifecycle-query-service.d.ts +75 -0
  108. package/dist/src/native-thread-lifecycle-query-service.js +297 -0
  109. package/dist/src/native-thread-lifecycle-query-service.js.map +1 -0
  110. package/dist/src/native-thread-lifecycle-recovery-adapter.d.ts +45 -0
  111. package/dist/src/native-thread-lifecycle-recovery-adapter.js +154 -0
  112. package/dist/src/native-thread-lifecycle-recovery-adapter.js.map +1 -0
  113. package/dist/src/native-thread-lifecycle-recovery-service.d.ts +211 -0
  114. package/dist/src/native-thread-lifecycle-recovery-service.js +1093 -0
  115. package/dist/src/native-thread-lifecycle-recovery-service.js.map +1 -0
  116. package/dist/src/native-thread-resume-snapshot-policy.d.ts +73 -0
  117. package/dist/src/native-thread-resume-snapshot-policy.js +218 -0
  118. package/dist/src/native-thread-resume-snapshot-policy.js.map +1 -0
  119. package/dist/src/native-thread-resume-snapshot.d.ts +3 -61
  120. package/dist/src/native-thread-resume-snapshot.js +2 -143
  121. package/dist/src/native-thread-resume-snapshot.js.map +1 -1
  122. package/dist/src/native-thread-transition-application.d.ts +147 -0
  123. package/dist/src/native-thread-transition-application.js +974 -0
  124. package/dist/src/native-thread-transition-application.js.map +1 -0
  125. package/dist/src/native-thread-transition-policy.d.ts +127 -0
  126. package/dist/src/native-thread-transition-policy.js +154 -0
  127. package/dist/src/native-thread-transition-policy.js.map +1 -0
  128. package/dist/src/native-thread-transition-resource-adapter.d.ts +12 -0
  129. package/dist/src/native-thread-transition-resource-adapter.js +44 -0
  130. package/dist/src/native-thread-transition-resource-adapter.js.map +1 -0
  131. package/dist/src/native-thread-transition-settlement-service.d.ts +94 -0
  132. package/dist/src/native-thread-transition-settlement-service.js +134 -0
  133. package/dist/src/native-thread-transition-settlement-service.js.map +1 -0
  134. package/dist/src/native-thread-transition-verification-adapter.d.ts +62 -0
  135. package/dist/src/native-thread-transition-verification-adapter.js +451 -0
  136. package/dist/src/native-thread-transition-verification-adapter.js.map +1 -0
  137. package/dist/src/openclaw-callback-transport.d.ts +69 -0
  138. package/dist/src/openclaw-callback-transport.js +583 -0
  139. package/dist/src/openclaw-callback-transport.js.map +1 -0
  140. package/dist/src/openclaw-plugin-callback-adapter.d.ts +1 -0
  141. package/dist/src/openclaw-plugin-callback-adapter.js +423 -0
  142. package/dist/src/openclaw-plugin-callback-adapter.js.map +1 -0
  143. package/dist/src/openclaw-plugin-command-adapter.d.ts +16 -0
  144. package/dist/src/openclaw-plugin-command-adapter.js +1868 -0
  145. package/dist/src/openclaw-plugin-command-adapter.js.map +1 -0
  146. package/dist/src/openclaw-plugin-helpers.d.ts +27 -4
  147. package/dist/src/openclaw-plugin-helpers.js +356 -81
  148. package/dist/src/openclaw-plugin-helpers.js.map +1 -1
  149. package/dist/src/openclaw-plugin-schemas.d.ts +358 -0
  150. package/dist/src/openclaw-plugin-schemas.js +366 -0
  151. package/dist/src/openclaw-plugin-schemas.js.map +1 -0
  152. package/dist/src/openclaw-plugin-supervisor.d.ts +6 -0
  153. package/dist/src/openclaw-plugin-supervisor.js +123 -0
  154. package/dist/src/openclaw-plugin-supervisor.js.map +1 -0
  155. package/dist/src/openclaw-plugin.js +7 -2212
  156. package/dist/src/openclaw-plugin.js.map +1 -1
  157. package/dist/src/openclaw-private-authority-offers.d.ts +22 -0
  158. package/dist/src/openclaw-private-authority-offers.js +177 -0
  159. package/dist/src/openclaw-private-authority-offers.js.map +1 -0
  160. package/dist/src/protocol.d.ts +5 -0
  161. package/dist/src/protocol.js +59 -3
  162. package/dist/src/protocol.js.map +1 -1
  163. package/dist/src/session-store.d.ts +1 -0
  164. package/dist/src/session-store.js +84 -106
  165. package/dist/src/session-store.js.map +1 -1
  166. package/dist/src/store.d.ts +1 -0
  167. package/dist/src/store.js +5 -2
  168. package/dist/src/store.js.map +1 -1
  169. package/dist/src/terminal-acceptance-application-service.d.ts +65 -0
  170. package/dist/src/terminal-acceptance-application-service.js +63 -0
  171. package/dist/src/terminal-acceptance-application-service.js.map +1 -0
  172. package/dist/src/terminal-acceptance-cli-adapter.d.ts +210 -0
  173. package/dist/src/terminal-acceptance-cli-adapter.js +957 -0
  174. package/dist/src/terminal-acceptance-cli-adapter.js.map +1 -0
  175. package/dist/src/terminal-action-projection.d.ts +309 -0
  176. package/dist/src/terminal-action-projection.js +376 -0
  177. package/dist/src/terminal-action-projection.js.map +1 -0
  178. package/dist/src/terminal-agent-bridge.d.ts +3 -0
  179. package/dist/src/terminal-agent-bridge.js +29 -8
  180. package/dist/src/terminal-agent-bridge.js.map +1 -1
  181. package/dist/src/terminal-authority-policy.d.ts +141 -0
  182. package/dist/src/terminal-authority-policy.js +367 -0
  183. package/dist/src/terminal-authority-policy.js.map +1 -0
  184. package/dist/src/terminal-binding-authority.d.ts +118 -0
  185. package/dist/src/terminal-binding-authority.js +245 -0
  186. package/dist/src/terminal-binding-authority.js.map +1 -0
  187. package/dist/src/terminal-binding-reconciliation-service.d.ts +75 -0
  188. package/dist/src/terminal-binding-reconciliation-service.js +73 -0
  189. package/dist/src/terminal-binding-reconciliation-service.js.map +1 -0
  190. package/dist/src/terminal-command-cli-adapter.d.ts +380 -0
  191. package/dist/src/terminal-command-cli-adapter.js +3288 -0
  192. package/dist/src/terminal-command-cli-adapter.js.map +1 -0
  193. package/dist/src/terminal-control-ref.d.ts +4 -0
  194. package/dist/src/terminal-control-ref.js +11 -8
  195. package/dist/src/terminal-control-ref.js.map +1 -1
  196. package/dist/src/terminal-delegate-cli-adapter.d.ts +41 -0
  197. package/dist/src/terminal-delegate-cli-adapter.js +242 -0
  198. package/dist/src/terminal-delegate-cli-adapter.js.map +1 -0
  199. package/dist/src/terminal-dispatch-abort.d.ts +22 -0
  200. package/dist/src/terminal-dispatch-abort.js +30 -0
  201. package/dist/src/terminal-dispatch-abort.js.map +1 -0
  202. package/dist/src/terminal-dispatch-application.d.ts +115 -0
  203. package/dist/src/terminal-dispatch-application.js +478 -0
  204. package/dist/src/terminal-dispatch-application.js.map +1 -0
  205. package/dist/src/terminal-dispatch-capability.d.ts +63 -0
  206. package/dist/src/terminal-dispatch-capability.js +133 -0
  207. package/dist/src/terminal-dispatch-capability.js.map +1 -0
  208. package/dist/src/terminal-dispatch-completion-cli-adapter.d.ts +22 -0
  209. package/dist/src/terminal-dispatch-completion-cli-adapter.js +96 -0
  210. package/dist/src/terminal-dispatch-completion-cli-adapter.js.map +1 -0
  211. package/dist/src/terminal-dispatch-composition.d.ts +79 -0
  212. package/dist/src/terminal-dispatch-composition.js +2 -0
  213. package/dist/src/terminal-dispatch-composition.js.map +1 -0
  214. package/dist/src/terminal-dispatch-execution.d.ts +290 -0
  215. package/dist/src/terminal-dispatch-execution.js +916 -0
  216. package/dist/src/terminal-dispatch-execution.js.map +1 -0
  217. package/dist/src/terminal-dispatch-ledger-codec.d.ts +110 -0
  218. package/dist/src/terminal-dispatch-ledger-codec.js +399 -0
  219. package/dist/src/terminal-dispatch-ledger-codec.js.map +1 -0
  220. package/dist/src/terminal-dispatch-policy.d.ts +93 -0
  221. package/dist/src/terminal-dispatch-policy.js +122 -0
  222. package/dist/src/terminal-dispatch-policy.js.map +1 -0
  223. package/dist/src/terminal-dispatch-presenter.d.ts +65 -0
  224. package/dist/src/terminal-dispatch-presenter.js +258 -0
  225. package/dist/src/terminal-dispatch-presenter.js.map +1 -0
  226. package/dist/src/terminal-dispatch-receipt.d.ts +79 -0
  227. package/dist/src/terminal-dispatch-receipt.js +314 -0
  228. package/dist/src/terminal-dispatch-receipt.js.map +1 -0
  229. package/dist/src/terminal-dispatch-recovery-cli-adapter.d.ts +132 -0
  230. package/dist/src/terminal-dispatch-recovery-cli-adapter.js +1330 -0
  231. package/dist/src/terminal-dispatch-recovery-cli-adapter.js.map +1 -0
  232. package/dist/src/terminal-dispatch-recovery-service.d.ts +271 -0
  233. package/dist/src/terminal-dispatch-recovery-service.js +374 -0
  234. package/dist/src/terminal-dispatch-recovery-service.js.map +1 -0
  235. package/dist/src/terminal-dispatch-repository-cli-adapter.d.ts +35 -0
  236. package/dist/src/terminal-dispatch-repository-cli-adapter.js +483 -0
  237. package/dist/src/terminal-dispatch-repository-cli-adapter.js.map +1 -0
  238. package/dist/src/terminal-handoff-application-service.d.ts +7 -0
  239. package/dist/src/terminal-handoff-application-service.js +18 -0
  240. package/dist/src/terminal-handoff-application-service.js.map +1 -0
  241. package/dist/src/terminal-handoff-cli-adapter.d.ts +229 -0
  242. package/dist/src/terminal-handoff-cli-adapter.js +1389 -0
  243. package/dist/src/terminal-handoff-cli-adapter.js.map +1 -0
  244. package/dist/src/terminal-handoff-facts.d.ts +12 -0
  245. package/dist/src/terminal-handoff-facts.js +16 -0
  246. package/dist/src/terminal-handoff-facts.js.map +1 -0
  247. package/dist/src/terminal-identity-authority-cli-adapter.d.ts +318 -0
  248. package/dist/src/terminal-identity-authority-cli-adapter.js +1072 -0
  249. package/dist/src/terminal-identity-authority-cli-adapter.js.map +1 -0
  250. package/dist/src/terminal-identity-authority-service.d.ts +48 -0
  251. package/dist/src/terminal-identity-authority-service.js +45 -0
  252. package/dist/src/terminal-identity-authority-service.js.map +1 -0
  253. package/dist/src/terminal-list-cli-adapter.d.ts +274 -0
  254. package/dist/src/terminal-list-cli-adapter.js +2444 -0
  255. package/dist/src/terminal-list-cli-adapter.js.map +1 -0
  256. package/dist/src/terminal-list-renderer.d.ts +34 -0
  257. package/dist/src/terminal-list-renderer.js +643 -0
  258. package/dist/src/terminal-list-renderer.js.map +1 -0
  259. package/dist/src/terminal-maintenance-cli-adapter.d.ts +102 -0
  260. package/dist/src/terminal-maintenance-cli-adapter.js +1059 -0
  261. package/dist/src/terminal-maintenance-cli-adapter.js.map +1 -0
  262. package/dist/src/terminal-monitor-application-service.d.ts +275 -0
  263. package/dist/src/terminal-monitor-application-service.js +982 -0
  264. package/dist/src/terminal-monitor-application-service.js.map +1 -0
  265. package/dist/src/terminal-monitor-cli-adapter.d.ts +130 -0
  266. package/dist/src/terminal-monitor-cli-adapter.js +442 -0
  267. package/dist/src/terminal-monitor-cli-adapter.js.map +1 -0
  268. package/dist/src/terminal-monitor-decision-policy.d.ts +98 -0
  269. package/dist/src/terminal-monitor-decision-policy.js +246 -0
  270. package/dist/src/terminal-monitor-decision-policy.js.map +1 -0
  271. package/dist/src/terminal-monitor-launch-plan.d.ts +45 -0
  272. package/dist/src/terminal-monitor-launch-plan.js +94 -0
  273. package/dist/src/terminal-monitor-launch-plan.js.map +1 -0
  274. package/dist/src/terminal-monitor-ownership-policy.d.ts +31 -0
  275. package/dist/src/terminal-monitor-ownership-policy.js +64 -0
  276. package/dist/src/terminal-monitor-ownership-policy.js.map +1 -0
  277. package/dist/src/terminal-monitor-poll-policy.d.ts +48 -0
  278. package/dist/src/terminal-monitor-poll-policy.js +67 -0
  279. package/dist/src/terminal-monitor-poll-policy.js.map +1 -0
  280. package/dist/src/terminal-monitor-reconciliation-eligibility.d.ts +53 -0
  281. package/dist/src/terminal-monitor-reconciliation-eligibility.js +114 -0
  282. package/dist/src/terminal-monitor-reconciliation-eligibility.js.map +1 -0
  283. package/dist/src/terminal-monitor-state-cli-adapter.d.ts +106 -0
  284. package/dist/src/terminal-monitor-state-cli-adapter.js +1492 -0
  285. package/dist/src/terminal-monitor-state-cli-adapter.js.map +1 -0
  286. package/dist/src/terminal-monitor-state-reconciliation-service.d.ts +87 -0
  287. package/dist/src/terminal-monitor-state-reconciliation-service.js +106 -0
  288. package/dist/src/terminal-monitor-state-reconciliation-service.js.map +1 -0
  289. package/dist/src/terminal-monitor-supervision-cli-adapter.d.ts +122 -0
  290. package/dist/src/terminal-monitor-supervision-cli-adapter.js +685 -0
  291. package/dist/src/terminal-monitor-supervision-cli-adapter.js.map +1 -0
  292. package/dist/src/terminal-process-facts.d.ts +2 -0
  293. package/dist/src/terminal-process-facts.js +19 -0
  294. package/dist/src/terminal-process-facts.js.map +1 -0
  295. package/dist/src/terminal-process-source.d.ts +6 -4
  296. package/dist/src/terminal-process-source.js +25 -20
  297. package/dist/src/terminal-process-source.js.map +1 -1
  298. package/dist/src/terminal-runtime-cli-adapter.d.ts +80 -0
  299. package/dist/src/terminal-runtime-cli-adapter.js +488 -0
  300. package/dist/src/terminal-runtime-cli-adapter.js.map +1 -0
  301. package/dist/src/terminal-scoped-approval-authority.d.ts +62 -0
  302. package/dist/src/terminal-scoped-approval-authority.js +281 -0
  303. package/dist/src/terminal-scoped-approval-authority.js.map +1 -0
  304. package/dist/src/terminal-selector-projection-service.d.ts +26 -0
  305. package/dist/src/terminal-selector-projection-service.js +81 -0
  306. package/dist/src/terminal-selector-projection-service.js.map +1 -0
  307. package/dist/src/terminal-status-cli-adapter.d.ts +126 -0
  308. package/dist/src/terminal-status-cli-adapter.js +577 -0
  309. package/dist/src/terminal-status-cli-adapter.js.map +1 -0
  310. package/dist/src/terminal-status-facts.d.ts +56 -0
  311. package/dist/src/terminal-status-facts.js +199 -0
  312. package/dist/src/terminal-status-facts.js.map +1 -0
  313. package/dist/src/terminal-submission-acceptance.d.ts +62 -145
  314. package/dist/src/terminal-submission-acceptance.js +555 -222
  315. package/dist/src/terminal-submission-acceptance.js.map +1 -1
  316. package/dist/src/terminal-submission-facts.d.ts +123 -0
  317. package/dist/src/terminal-submission-facts.js +205 -0
  318. package/dist/src/terminal-submission-facts.js.map +1 -0
  319. package/dist/src/terminal-turn-binding-authority-cli-adapter.d.ts +14 -0
  320. package/dist/src/terminal-turn-binding-authority-cli-adapter.js +90 -0
  321. package/dist/src/terminal-turn-binding-authority-cli-adapter.js.map +1 -0
  322. package/dist/src/terminal-watch-callback-cli-adapter.d.ts +20 -0
  323. package/dist/src/terminal-watch-callback-cli-adapter.js +55 -0
  324. package/dist/src/terminal-watch-callback-cli-adapter.js.map +1 -0
  325. package/dist/src/terminal-watch-cli-adapter.d.ts +64 -0
  326. package/dist/src/terminal-watch-cli-adapter.js +508 -0
  327. package/dist/src/terminal-watch-cli-adapter.js.map +1 -0
  328. package/dist/src/terminal-watch-service.d.ts +97 -0
  329. package/dist/src/terminal-watch-service.js +714 -0
  330. package/dist/src/terminal-watch-service.js.map +1 -0
  331. package/dist/src/terminal-watch-store.d.ts +149 -0
  332. package/dist/src/terminal-watch-store.js +861 -0
  333. package/dist/src/terminal-watch-store.js.map +1 -0
  334. package/dist/src/value-guards.d.ts +4 -0
  335. package/dist/src/value-guards.js +12 -0
  336. package/dist/src/value-guards.js.map +1 -0
  337. package/dist/src/verified-dead-agent-policy.d.ts +192 -0
  338. package/dist/src/verified-dead-agent-policy.js +262 -0
  339. package/dist/src/verified-dead-agent-policy.js.map +1 -0
  340. package/docs/quickstart-herdr.md +8 -0
  341. package/docs/quickstart-tmux.md +33 -6
  342. package/openclaw.plugin.json +11 -3
  343. package/package.json +3 -1
  344. package/templates/openclaw-skills/agent-knock-knock/SKILL.md +58 -40
@@ -0,0 +1 @@
1
+ {"version":3,"file":"native-thread-transition-verification-adapter.js","sourceRoot":"","sources":["../../src/native-thread-transition-verification-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ import type { CallbackDeliveryOptions, CallbackDeliveryOutcome, DeliverCallbackInput } from "./callback-outbox-policy.js";
2
+ import { type AgentMessage, type Conversation } from "./protocol.js";
3
+ export type CallbackWakeAcknowledgementStatus = "started" | "in_flight" | "ok" | "error" | "timeout";
4
+ export interface CallbackProcessDelivery {
5
+ status: number;
6
+ stdout: string;
7
+ stderr: string;
8
+ }
9
+ export interface CallbackSpawnResult {
10
+ status: number | null;
11
+ stdout?: string | null;
12
+ stderr?: string | null;
13
+ error?: Error;
14
+ }
15
+ interface CallbackSpawnOptions {
16
+ encoding: "utf8";
17
+ maxBuffer: number;
18
+ timeout: number;
19
+ killSignal: "SIGKILL";
20
+ env: NodeJS.ProcessEnv;
21
+ }
22
+ export type CallbackSpawnSync = (command: string, args: string[], options: CallbackSpawnOptions) => CallbackSpawnResult;
23
+ export interface CallbackProcessDeliveryObservation {
24
+ logPath: string;
25
+ conversation: Conversation;
26
+ message: AgentMessage;
27
+ event: string;
28
+ runtimeEvent: string;
29
+ delivery: CallbackProcessDelivery;
30
+ detail?: Record<string, unknown>;
31
+ }
32
+ export interface OpenClawCallbackTransportPorts {
33
+ now(): Date;
34
+ environment(): NodeJS.ProcessEnv;
35
+ redactConversation(conversation: Conversation): unknown;
36
+ recordCallbackProcessDelivery(observation: CallbackProcessDeliveryObservation): void;
37
+ spawnSync?: CallbackSpawnSync;
38
+ }
39
+ export type OpenClawCallbackDeliveryOptions = CallbackDeliveryOptions;
40
+ export type DeliverOpenClawCallbackInput = DeliverCallbackInput;
41
+ export interface DeliverGatewayMethodInput {
42
+ method: string;
43
+ openclawBin?: string;
44
+ gatewayUrl?: string;
45
+ token?: string;
46
+ sessionKey?: string;
47
+ statePath: string;
48
+ logPath: string;
49
+ conversation: Conversation;
50
+ message: AgentMessage;
51
+ }
52
+ export interface DeliverChatSendInput {
53
+ openclawBin?: string;
54
+ gatewayUrl?: string;
55
+ token?: string;
56
+ params: Record<string, unknown>;
57
+ }
58
+ export interface OpenClawCallbackTransport {
59
+ deliverCallback(input: DeliverOpenClawCallbackInput): CallbackDeliveryOutcome;
60
+ deliverGatewayMethod(input: DeliverGatewayMethodInput): CallbackProcessDelivery;
61
+ deliverChatSend(input: DeliverChatSendInput): CallbackProcessDelivery;
62
+ }
63
+ export interface CallbackWakeAcknowledgement {
64
+ runId: string;
65
+ status: CallbackWakeAcknowledgementStatus;
66
+ }
67
+ export declare function parseChatSendAcknowledgement(text: unknown, expectedRunId: string): CallbackWakeAcknowledgement;
68
+ export declare function createOpenClawCallbackTransport(ports: OpenClawCallbackTransportPorts): OpenClawCallbackTransport;
69
+ export {};
@@ -0,0 +1,583 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { sessionIdForConversation, turnIdForConversation } from "./protocol.js";
3
+ import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
4
+ const CALLBACK_DELIVERY_TIMEOUT_MS = 30_000;
5
+ const CALLBACK_AGENT_WAIT_TIMEOUT_MS = 20_000;
6
+ const CALLBACK_AGENT_WAIT_CLI_TIMEOUT_MS = 25_000;
7
+ const CALLBACK_AGENT_WAIT_PROCESS_TIMEOUT_MS = 30_000;
8
+ const CALLBACK_PROCESS_MAX_BUFFER = 1024 * 1024 * 10;
9
+ function cleanProcessText(text) {
10
+ const value = String(text ?? "").trim();
11
+ return value ? value.slice(0, 2000) : undefined;
12
+ }
13
+ function parseOptionalJson(text) {
14
+ try {
15
+ return JSON.parse(String(text));
16
+ }
17
+ catch {
18
+ return undefined;
19
+ }
20
+ }
21
+ function parseRequiredGatewayDeliveryPayload(text) {
22
+ const payload = parseOptionalJson(text);
23
+ if (!isRecord(payload)) {
24
+ throw new Error("gateway callback returned malformed JSON");
25
+ }
26
+ if (payload.ok !== true) {
27
+ throw new Error(`gateway callback was not accepted: ${stringValue(payload.error) ??
28
+ stringValue(payload.message) ??
29
+ "ok was not true"}`);
30
+ }
31
+ if (payload.delivery_required !== undefined &&
32
+ typeof payload.delivery_required !== "boolean") {
33
+ throw new Error("gateway callback returned an invalid delivery_required value");
34
+ }
35
+ return payload;
36
+ }
37
+ function parseGatewayCallbackDeliveryPlan(payload) {
38
+ const chatSendParams = isRecord(payload.chat_send)
39
+ ? payload.chat_send
40
+ : undefined;
41
+ const sessionSendParams = isRecord(payload.session_send)
42
+ ? payload.session_send
43
+ : undefined;
44
+ if (chatSendParams && sessionSendParams) {
45
+ throw new Error("gateway callback returned multiple delivery plans");
46
+ }
47
+ const deliveryRequired = payload.delivery_required === true;
48
+ const deliveryExplicitlyNotRequired = payload.delivery_required === false;
49
+ const deliveryMode = stringValue(payload.delivery_mode);
50
+ if (deliveryRequired && !chatSendParams && !sessionSendParams) {
51
+ throw new Error("gateway callback requires delivery but returned no supported " +
52
+ "chat_send or session_send plan");
53
+ }
54
+ if (deliveryExplicitlyNotRequired && (chatSendParams || sessionSendParams)) {
55
+ throw new Error("gateway callback returned a delivery plan without delivery_required");
56
+ }
57
+ if (deliveryMode && deliveryMode !== "none") {
58
+ const expectedMode = chatSendParams
59
+ ? "chat.send"
60
+ : sessionSendParams
61
+ ? "sessions.send"
62
+ : undefined;
63
+ if (deliveryMode !== expectedMode) {
64
+ throw new Error("gateway callback delivery_mode does not match its delivery plan");
65
+ }
66
+ }
67
+ if (deliveryMode === "none" && deliveryRequired) {
68
+ throw new Error("gateway callback delivery_mode none cannot require delivery");
69
+ }
70
+ if (chatSendParams) {
71
+ if (!stringValue(chatSendParams.sessionKey) ||
72
+ !stringValue(chatSendParams.message) ||
73
+ !stringValue(chatSendParams.idempotencyKey) ||
74
+ chatSendParams.deliver !== true) {
75
+ throw new Error("gateway callback returned an invalid chat_send delivery plan");
76
+ }
77
+ }
78
+ if (sessionSendParams) {
79
+ if (!stringValue(sessionSendParams.key) ||
80
+ !stringValue(sessionSendParams.message) ||
81
+ !stringValue(sessionSendParams.idempotencyKey)) {
82
+ throw new Error("gateway callback returned an invalid session_send delivery plan");
83
+ }
84
+ }
85
+ return { chatSendParams, sessionSendParams };
86
+ }
87
+ export function parseChatSendAcknowledgement(text, expectedRunId) {
88
+ const payload = parseOptionalJson(text);
89
+ if (!isRecord(payload)) {
90
+ throw new Error("chat.send returned malformed JSON");
91
+ }
92
+ const runId = stringValue(payload.runId);
93
+ const status = stringValue(payload.status);
94
+ if (!runId) {
95
+ throw new Error("chat.send acknowledgement is missing runId");
96
+ }
97
+ if (runId !== expectedRunId) {
98
+ throw new Error("chat.send acknowledgement runId does not match its idempotencyKey");
99
+ }
100
+ if (!status ||
101
+ !["started", "in_flight", "ok", "error", "timeout"].includes(status)) {
102
+ throw new Error(`chat.send returned unexpected status ${JSON.stringify(status ?? null)}`);
103
+ }
104
+ return {
105
+ runId,
106
+ status: status
107
+ };
108
+ }
109
+ function parseAgentWaitResult(text, expectedRunId) {
110
+ const payload = parseOptionalJson(text);
111
+ if (!isRecord(payload)) {
112
+ throw new Error("agent.wait returned malformed JSON");
113
+ }
114
+ if (stringValue(payload.runId) !== expectedRunId) {
115
+ throw new Error("agent.wait returned a result for a different runId");
116
+ }
117
+ const status = stringValue(payload.status);
118
+ if (!status || !["ok", "error", "timeout", "pending"].includes(status)) {
119
+ throw new Error(`agent.wait returned unexpected status ${JSON.stringify(status ?? null)}`);
120
+ }
121
+ return payload;
122
+ }
123
+ function normalizeCallbackProcessDelivery(result) {
124
+ if (result.error) {
125
+ return {
126
+ status: 1,
127
+ stdout: result.stdout ?? "",
128
+ stderr: result.error.message
129
+ };
130
+ }
131
+ return {
132
+ status: result.status ?? 1,
133
+ stdout: result.stdout ?? "",
134
+ stderr: result.stderr ?? ""
135
+ };
136
+ }
137
+ function observeCallbackAgentRun(ports, deliverAgentWait, { options, logPath, conversation, message, wakeAck }) {
138
+ if (["ok", "error", "timeout"].includes(wakeAck.status)) {
139
+ return {
140
+ status: wakeAck.status,
141
+ source: "wake_acknowledgement",
142
+ observed_at: ports.now().toISOString()
143
+ };
144
+ }
145
+ const agentWaitDelivery = deliverAgentWait({
146
+ openclawBin: options.openclawBin,
147
+ gatewayUrl: options.gatewayUrl,
148
+ token: options.token,
149
+ runId: wakeAck.runId
150
+ });
151
+ if (agentWaitDelivery.status !== 0) {
152
+ ports.recordCallbackProcessDelivery({
153
+ logPath,
154
+ conversation,
155
+ message,
156
+ event: "callback_agent_wait_delivery",
157
+ runtimeEvent: "callback_agent_wait_delivery",
158
+ delivery: agentWaitDelivery,
159
+ detail: { run_id: wakeAck.runId }
160
+ });
161
+ return {
162
+ status: "unavailable",
163
+ run_id: wakeAck.runId,
164
+ observed_at: ports.now().toISOString(),
165
+ error: cleanProcessText(agentWaitDelivery.stderr ||
166
+ agentWaitDelivery.stdout ||
167
+ `agent.wait failed with status ${agentWaitDelivery.status}`)
168
+ };
169
+ }
170
+ let waitResult;
171
+ try {
172
+ waitResult = parseAgentWaitResult(agentWaitDelivery.stdout, wakeAck.runId);
173
+ }
174
+ catch (error) {
175
+ ports.recordCallbackProcessDelivery({
176
+ logPath,
177
+ conversation,
178
+ message,
179
+ event: "callback_agent_wait_delivery",
180
+ runtimeEvent: "callback_agent_wait_delivery",
181
+ delivery: agentWaitDelivery,
182
+ detail: {
183
+ run_id: wakeAck.runId,
184
+ observation_error: String(error)
185
+ }
186
+ });
187
+ return {
188
+ status: "invalid",
189
+ run_id: wakeAck.runId,
190
+ observed_at: ports.now().toISOString(),
191
+ error: error instanceof Error ? error.message : String(error)
192
+ };
193
+ }
194
+ ports.recordCallbackProcessDelivery({
195
+ logPath,
196
+ conversation,
197
+ message,
198
+ event: "callback_agent_wait_delivery",
199
+ runtimeEvent: "callback_agent_wait_delivery",
200
+ delivery: agentWaitDelivery,
201
+ detail: {
202
+ run_id: wakeAck.runId,
203
+ run_status: waitResult.status
204
+ }
205
+ });
206
+ return {
207
+ status: waitResult.status,
208
+ run_id: wakeAck.runId,
209
+ observed_at: ports.now().toISOString(),
210
+ ...(stringValue(waitResult.error)
211
+ ? { error: stringValue(waitResult.error) }
212
+ : {}),
213
+ ...(stringValue(waitResult.stopReason)
214
+ ? { stop_reason: stringValue(waitResult.stopReason) }
215
+ : {}),
216
+ ...(stringValue(waitResult.timeoutPhase)
217
+ ? { timeout_phase: stringValue(waitResult.timeoutPhase) }
218
+ : {}),
219
+ ...(typeof waitResult.providerStarted === "boolean"
220
+ ? { provider_started: waitResult.providerStarted }
221
+ : {})
222
+ };
223
+ }
224
+ export function createOpenClawCallbackTransport(ports) {
225
+ const runSync = ports.spawnSync ??
226
+ ((command, args, options) => spawnSync(command, args, options));
227
+ function openClawGatewayEnvironment(token) {
228
+ if (!token || token === "<token>") {
229
+ return ports.environment();
230
+ }
231
+ return {
232
+ ...ports.environment(),
233
+ OPENCLAW_GATEWAY_TOKEN: token
234
+ };
235
+ }
236
+ function deliverGatewayMethod({ method, openclawBin, gatewayUrl, token, sessionKey, statePath, logPath, conversation, message }) {
237
+ const args = [
238
+ "gateway",
239
+ "call",
240
+ method,
241
+ "--params",
242
+ JSON.stringify({
243
+ sessionKey,
244
+ session_id: sessionIdForConversation(conversation),
245
+ turn_id: turnIdForConversation(conversation),
246
+ statePath,
247
+ logPath,
248
+ conversation: ports.redactConversation(conversation),
249
+ message
250
+ }),
251
+ "--json"
252
+ ];
253
+ if (gatewayUrl) {
254
+ args.push("--url", gatewayUrl);
255
+ }
256
+ const result = runSync(openclawBin ?? "openclaw", args, {
257
+ encoding: "utf8",
258
+ maxBuffer: CALLBACK_PROCESS_MAX_BUFFER,
259
+ timeout: CALLBACK_DELIVERY_TIMEOUT_MS,
260
+ killSignal: "SIGKILL",
261
+ env: openClawGatewayEnvironment(token)
262
+ });
263
+ return normalizeCallbackProcessDelivery(result);
264
+ }
265
+ function deliverSessionSend({ openclawBin, gatewayUrl, token, params }) {
266
+ const args = [
267
+ "gateway",
268
+ "call",
269
+ "sessions.send",
270
+ "--params",
271
+ JSON.stringify(params),
272
+ "--json"
273
+ ];
274
+ if (gatewayUrl) {
275
+ args.push("--url", gatewayUrl);
276
+ }
277
+ const result = runSync(openclawBin ?? "openclaw", args, {
278
+ encoding: "utf8",
279
+ maxBuffer: CALLBACK_PROCESS_MAX_BUFFER,
280
+ timeout: CALLBACK_DELIVERY_TIMEOUT_MS,
281
+ killSignal: "SIGKILL",
282
+ env: openClawGatewayEnvironment(token)
283
+ });
284
+ return normalizeCallbackProcessDelivery(result);
285
+ }
286
+ function deliverChatSend({ openclawBin, gatewayUrl, token, params }) {
287
+ const args = [
288
+ "gateway",
289
+ "call",
290
+ "chat.send",
291
+ "--params",
292
+ JSON.stringify(params),
293
+ "--json"
294
+ ];
295
+ if (gatewayUrl) {
296
+ args.push("--url", gatewayUrl);
297
+ }
298
+ const result = runSync(openclawBin ?? "openclaw", args, {
299
+ encoding: "utf8",
300
+ maxBuffer: CALLBACK_PROCESS_MAX_BUFFER,
301
+ timeout: CALLBACK_DELIVERY_TIMEOUT_MS,
302
+ killSignal: "SIGKILL",
303
+ env: openClawGatewayEnvironment(token)
304
+ });
305
+ return normalizeCallbackProcessDelivery(result);
306
+ }
307
+ function deliverAgentWait({ openclawBin, gatewayUrl, token, runId }) {
308
+ const args = [
309
+ "gateway",
310
+ "call",
311
+ "agent.wait",
312
+ "--params",
313
+ JSON.stringify({
314
+ runId,
315
+ timeoutMs: CALLBACK_AGENT_WAIT_TIMEOUT_MS
316
+ }),
317
+ "--json",
318
+ "--timeout",
319
+ String(CALLBACK_AGENT_WAIT_CLI_TIMEOUT_MS)
320
+ ];
321
+ if (gatewayUrl) {
322
+ args.push("--url", gatewayUrl);
323
+ }
324
+ const result = runSync(openclawBin ?? "openclaw", args, {
325
+ encoding: "utf8",
326
+ maxBuffer: CALLBACK_PROCESS_MAX_BUFFER,
327
+ timeout: CALLBACK_AGENT_WAIT_PROCESS_TIMEOUT_MS,
328
+ killSignal: "SIGKILL",
329
+ env: openClawGatewayEnvironment(token)
330
+ });
331
+ return normalizeCallbackProcessDelivery(result);
332
+ }
333
+ function deliverCallback({ options, statePath, logPath, conversation, message, onProgress, onAccepted }) {
334
+ if (!options.gatewayMethod) {
335
+ throw new Error("callback delivery requires a configured OpenClaw gateway method");
336
+ }
337
+ const delivery = deliverGatewayMethod({
338
+ method: options.gatewayMethod,
339
+ openclawBin: options.openclawBin,
340
+ gatewayUrl: options.gatewayUrl,
341
+ token: options.token,
342
+ sessionKey: options.gatewaySession ??
343
+ options.openclawSession ??
344
+ conversation.openclaw_session,
345
+ statePath,
346
+ logPath,
347
+ conversation,
348
+ message
349
+ });
350
+ if (delivery.status !== 0) {
351
+ ports.recordCallbackProcessDelivery({
352
+ logPath,
353
+ conversation,
354
+ message,
355
+ event: "callback_gateway_method_delivery",
356
+ runtimeEvent: "callback_gateway_method_delivery",
357
+ delivery,
358
+ detail: { method: options.gatewayMethod }
359
+ });
360
+ throw new Error(delivery.stderr ||
361
+ delivery.stdout ||
362
+ `gateway method delivery failed with status ${delivery.status}`);
363
+ }
364
+ const gatewayPayload = parseRequiredGatewayDeliveryPayload(delivery.stdout);
365
+ const { chatSendParams, sessionSendParams } = parseGatewayCallbackDeliveryPlan(gatewayPayload);
366
+ const explicitlyEnqueued = typeof gatewayPayload.enqueued === "boolean"
367
+ ? gatewayPayload.enqueued
368
+ : undefined;
369
+ const gatewayHandledWithoutInjection = gatewayPayload.auto_approved === true ||
370
+ gatewayPayload.approval_already_handled === true;
371
+ const injectionObservedAt = ports.now().toISOString();
372
+ let injection = {
373
+ status: gatewayHandledWithoutInjection || explicitlyEnqueued === true
374
+ ? "accepted"
375
+ : explicitlyEnqueued === false
376
+ ? "uncertain"
377
+ : "unconfirmed",
378
+ enqueued: explicitlyEnqueued,
379
+ injection_id: stringValue(gatewayPayload.injection_id),
380
+ ...(gatewayHandledWithoutInjection || explicitlyEnqueued === true
381
+ ? { accepted_at: injectionObservedAt }
382
+ : { observed_at: injectionObservedAt }),
383
+ evidence: gatewayHandledWithoutInjection
384
+ ? "gateway_handled_callback_without_injection"
385
+ : explicitlyEnqueued === true
386
+ ? "next_turn_injection_enqueued"
387
+ : explicitlyEnqueued === false
388
+ ? "gateway_ok_but_enqueue_unconfirmed"
389
+ : "legacy_gateway_ack_without_enqueue_field"
390
+ };
391
+ const wakePlan = chatSendParams
392
+ ? {
393
+ mode: "chat.send",
394
+ params: chatSendParams,
395
+ event: "callback_chat_send_delivery",
396
+ deliver: deliverChatSend,
397
+ kind: "gateway_method+chat_send"
398
+ }
399
+ : sessionSendParams
400
+ ? {
401
+ mode: "sessions.send",
402
+ params: sessionSendParams,
403
+ event: "callback_session_send_delivery",
404
+ deliver: deliverSessionSend,
405
+ kind: "gateway_method+sessions_send"
406
+ }
407
+ : undefined;
408
+ const initialWake = wakePlan
409
+ ? {
410
+ status: "not_attempted",
411
+ mode: wakePlan.mode,
412
+ observed_at: injectionObservedAt
413
+ }
414
+ : {
415
+ status: "not_required",
416
+ observed_at: injectionObservedAt
417
+ };
418
+ if (injection.status === "accepted") {
419
+ onAccepted?.({
420
+ kind: wakePlan?.kind ?? "gateway_method",
421
+ injection,
422
+ wake: initialWake
423
+ });
424
+ }
425
+ onProgress?.({
426
+ stage: "gateway_injection",
427
+ injection
428
+ });
429
+ ports.recordCallbackProcessDelivery({
430
+ logPath,
431
+ conversation,
432
+ message,
433
+ event: "callback_gateway_method_delivery",
434
+ runtimeEvent: "callback_gateway_method_delivery",
435
+ delivery,
436
+ detail: { method: options.gatewayMethod }
437
+ });
438
+ if (!wakePlan) {
439
+ if (explicitlyEnqueued === false && !gatewayHandledWithoutInjection) {
440
+ throw new Error("gateway callback returned ok but did not confirm that its " +
441
+ "injection was enqueued");
442
+ }
443
+ if (injection.status === "unconfirmed") {
444
+ injection = {
445
+ ...injection,
446
+ status: "accepted",
447
+ accepted_at: ports.now().toISOString(),
448
+ evidence: "legacy_gateway_ok_without_wake_plan"
449
+ };
450
+ }
451
+ const wake = {
452
+ status: "not_required",
453
+ accepted_at: ports.now().toISOString()
454
+ };
455
+ const outcome = { kind: "gateway_method", injection, wake };
456
+ onAccepted?.(outcome);
457
+ onProgress?.({ stage: "wake_not_required", injection, wake });
458
+ return outcome;
459
+ }
460
+ const wakeDelivery = wakePlan.deliver({
461
+ openclawBin: options.openclawBin,
462
+ gatewayUrl: options.gatewayUrl,
463
+ token: options.token,
464
+ params: wakePlan.params
465
+ });
466
+ if (wakeDelivery.status !== 0) {
467
+ const wake = {
468
+ status: "failed",
469
+ mode: wakePlan.mode,
470
+ failed_at: ports.now().toISOString(),
471
+ error: cleanProcessText(wakeDelivery.stderr ||
472
+ wakeDelivery.stdout ||
473
+ `wake delivery failed with status ${wakeDelivery.status}`)
474
+ };
475
+ const outcome = { kind: wakePlan.kind, injection, wake };
476
+ if (injection.status === "accepted") {
477
+ onAccepted?.(outcome);
478
+ }
479
+ ports.recordCallbackProcessDelivery({
480
+ logPath,
481
+ conversation,
482
+ message,
483
+ event: wakePlan.event,
484
+ runtimeEvent: wakePlan.event,
485
+ delivery: wakeDelivery
486
+ });
487
+ onProgress?.({
488
+ stage: "wake_failed",
489
+ injection,
490
+ wake
491
+ });
492
+ if (injection.status === "accepted") {
493
+ return outcome;
494
+ }
495
+ throw new Error(wakeDelivery.stderr ||
496
+ wakeDelivery.stdout ||
497
+ `callback wake delivery failed with status ${wakeDelivery.status}`);
498
+ }
499
+ let wakeAck;
500
+ try {
501
+ wakeAck = parseChatSendAcknowledgement(wakeDelivery.stdout, String(wakePlan.params.idempotencyKey));
502
+ }
503
+ catch (error) {
504
+ const wake = {
505
+ status: "uncertain",
506
+ mode: wakePlan.mode,
507
+ observed_at: ports.now().toISOString(),
508
+ error: error instanceof Error ? error.message : String(error)
509
+ };
510
+ const outcome = { kind: wakePlan.kind, injection, wake };
511
+ if (injection.status === "accepted") {
512
+ onAccepted?.(outcome);
513
+ }
514
+ ports.recordCallbackProcessDelivery({
515
+ logPath,
516
+ conversation,
517
+ message,
518
+ event: wakePlan.event,
519
+ runtimeEvent: wakePlan.event,
520
+ delivery: wakeDelivery,
521
+ detail: { acknowledgement_error: String(error) }
522
+ });
523
+ onProgress?.({
524
+ stage: "wake_acknowledgement_invalid",
525
+ injection,
526
+ wake
527
+ });
528
+ if (injection.status === "accepted") {
529
+ return outcome;
530
+ }
531
+ throw error;
532
+ }
533
+ const wake = {
534
+ status: "accepted",
535
+ mode: wakePlan.mode,
536
+ run_id: wakeAck.runId,
537
+ acknowledgement_status: wakeAck.status,
538
+ idempotency_key: String(wakePlan.params.idempotencyKey),
539
+ accepted_at: ports.now().toISOString()
540
+ };
541
+ onAccepted?.({ kind: wakePlan.kind, injection, wake });
542
+ ports.recordCallbackProcessDelivery({
543
+ logPath,
544
+ conversation,
545
+ message,
546
+ event: wakePlan.event,
547
+ runtimeEvent: wakePlan.event,
548
+ delivery: wakeDelivery,
549
+ detail: {
550
+ run_id: wakeAck.runId,
551
+ run_status: wakeAck.status
552
+ }
553
+ });
554
+ onProgress?.({ stage: "wake_accepted", injection, wake });
555
+ const runObservation = observeCallbackAgentRun(ports, deliverAgentWait, {
556
+ options,
557
+ logPath,
558
+ conversation,
559
+ message,
560
+ wakeAck
561
+ });
562
+ const outcome = {
563
+ kind: wakePlan.kind,
564
+ injection,
565
+ wake,
566
+ run_observation: runObservation
567
+ };
568
+ onAccepted?.(outcome);
569
+ onProgress?.({
570
+ stage: "agent_run_observed",
571
+ injection,
572
+ wake,
573
+ run_observation: runObservation
574
+ });
575
+ return outcome;
576
+ }
577
+ return {
578
+ deliverCallback,
579
+ deliverGatewayMethod,
580
+ deliverChatSend
581
+ };
582
+ }
583
+ //# sourceMappingURL=openclaw-callback-transport.js.map