@scotthuang/agent-knock-knock 0.12.36 → 0.12.37

package/templates/openclaw-skills/agent-knock-knock/SKILL.md

@@ -160,7 +160,7 @@ After an asynchronous send operation is accepted, end the OpenClaw turn. Wait fo
 
 For managed terminal entries, `agent_knock_knock_status` captures AKK Turn state plus a bounded terminal screen and returns `terminal_screen`. With `watch_id`, it returns the exact durable Terminal Watch record, including `watch_mode`, `confidence`, and any warnings. It must not imply that an exact task completed when a `terminal_activity` Watch only observed stable idle, or that Watch sent/adopted the task. Neither form actively executes the coding agent's native `/status`. Use `agent_knock_knock_native_inspect` only for a terminal row's advertised, version-scoped native status action. Do not inspect the pane with raw provider or shell commands unless the relevant AKK inspection is unavailable or fails.
 
-For an exact managed Turn, Status may also return a native questionnaire `interaction_state`. The managed monitor proactively sends an `interaction_required` callback for each supported actionable step, but that callback is notification only: it does not create response authority. In the owning controller conversation, call Status with the callback's exact `turn_id`, treat the returned state as a single-use current-step projection rather than ordinary `waiting_for_openclaw` response text, and display it to the user. The private response offer exists only in the same controller conversation that displayed that Status result. Require `state="pending"` and `capabilities.respond=true`, review the projected question with the user, and pass only its semantic ids and typed answer to `agent_knock_knock_respond_interaction`. For a Codex custom answer, choose the guarded `Type something.` option advertised beside the exact client-generated `None of the above` row. AKK moves to that native Other row, opens its Notes editor, and the next fresh interaction accepts `free_text`; choosing `None of the above` itself still submits it directly without Notes. Codex delivers custom text as `user_note: ...` alongside the native Other label, not as a Claude-style bare value. One call answers one step; wait for the next callback or refresh Status after success because the next question, custom-text editor, or final confirmation has a new `interaction_id`. A `manual_required`, expired, changed, secret, multi-select, or uncertain interaction must remain for human inspection; do not send raw keys or retry blindly.
+For an exact managed Turn, Status may also return a native questionnaire `interaction_state`. The managed monitor proactively sends an `interaction_required` callback for each supported actionable step, but that callback is notification only: it does not create response authority. In the owning controller conversation, call Status with the callback's exact `turn_id`, treat the returned state as a single-use current-step projection rather than ordinary `waiting_for_openclaw` response text, and display it to the user. The private response offer exists only in the same controller conversation that displayed that Status result. Require `state="pending"` and `capabilities.respond=true`, review the projected question with the user, and pass only its semantic ids and typed answer to `agent_knock_knock_respond_interaction`. For a Codex custom answer, choose the guarded `Type something.` option advertised beside the exact client-generated `None of the above` row; AKK derives this semantic option when the client rendered only native Other. AKK moves to that native Other row, opens its Notes editor, and the next fresh interaction accepts `free_text`; choosing `None of the above` itself still submits it directly without Notes. Codex delivers custom text as `user_note: ...` alongside the native Other label, not as a Claude-style bare value. One call answers one step; wait for the next callback or refresh Status after success because the next question, custom-text editor, or final confirmation has a new `interaction_id`. If only the displayed `expires_at` has elapsed while its session-bound private offer remains live, Respond performs an exact locked terminal recapture before input; changed, missing, `manual_required`, secret, multi-select, or uncertain interactions still fail closed. Never send raw keys or retry blindly.
 
 ## Cancellation and Recovery