`gj?dZddlmZddlZddlmZmZmZeddhZ dZ ddZ dd Z dd Z dde dd  dd Zgd Zy)uTurn-end guard for kanban workers. Kanban workers must end with ``kanban_complete`` or ``kanban_block``. Models (especially GLM / Qwen families) sometimes narrate the next step ("Let me write the report now") and stop with ``finish_reason=stop`` and no tool calls. Hermes treats that as a clean exit → ``rc=0`` → dispatcher ``protocol_violation``. This module is policy-only: when a kanban worker tries to finish without a terminal board tool, return a bounded synthetic nudge so the conversation loop continues instead of exiting. ) annotationsN)AnyIterableOptionalkanban_complete kanban_blockctjjd}|!|jj dvrytjjdxsdj}t |S)zReturn whether the kanban stop-guard is active for this process. On when ``HERMES_KANBAN_TASK`` is set (dispatcher-spawned worker), unless ``HERMES_KANBAN_STOP_NUDGE`` explicitly disables it. HERMES_KANBAN_STOP_NUDGE>0noofffalseFHERMES_KANBAN_TASK)osenvirongetstriplowerbool)envtasks D/root/.hermes/venv/lib/python3.12/site-packages/agent/kanban_stop.pykanban_stop_nudge_enabledrsa **..3 4C 399;,,.2MM JJNN/ 0 6B = = ?D :cbt|tr]|jd}t|trt|jdxsdSt|jdxsdSt |dd}|tt |ddxsdStt |ddxsdS)Nfunctionnamer) isinstancedictrstrgetattr)tcfns r_tool_call_namer&&s"d VVJ  b$ rvvf~+, ,266&>'R(( Z &B ~72vr*0b11 wr62&," --rc |sy|D]}t|ts|jd}|dk(r/|jdxsgD]}t|tvsyY|dk(s_t |jdxsd}|tvsyy) zATrue if this conversation already invoked a terminal kanban tool.Frole assistant tool_callsTtoolrr)r r!rr&_TERMINAL_KANBAN_TOOLSr")messagesmsgr(r$rs rsession_called_kanban_terminalr/2s  #t$ wwv ; ggl+1r "2&*@@ V^swwv,"-D--  r)r-attempts max_attemptstask_idctsy||k\ryt|ry|xs#tjj dxsdj xsd}d|dS)zReturn a synthetic follow-up when a kanban worker exits without a terminal tool. Returns ``None`` when the guard should not fire (not a kanban worker, already completed/blocked, or nudge budget exhausted). Nrrz this taskzj[System: You are a Hermes kanban worker. A plain-text reply is NOT a terminal state for the board. Task `u!` is still `running`. Ending now without a board tool causes a protocol violation (clean exit with no `kanban_complete` / `kanban_block`). Do this immediately in your next response — do not narrate intent: 1. Finish any remaining deliverable (write the required file(s) now). 2. Call `kanban_complete(summary=..., artifacts=[...])` if the work is done, OR `kanban_block(reason=...)` if you are blocked. Never end a turn with only a promise of future action. Repeated protocol violations will block this task and require manual intervention.])rr/rrrr)r-r0r1r2tids rbuild_kanban_stop_nudger5Esi % &<%h/  @bjjnn%9: @b G G I X[C U U r)r5rr/)returnr)r$rr6r")r-Iterable[dict] | Noner6r) r-r7r0intr1r8r2 Optional[str]r6r9)__doc__ __future__rrtypingrrr frozensetr,_DEFAULT_MAX_ATTEMPTSrr&r/r5__all__rrrAs # **#$5~#FG  .*'+-! #       F r