hermes-agent/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current
flooryyyy f8d8f045fa feat(kanban): auto-subscribe calling session on kanban_create
When a worker calls kanban_create from inside a session that has a
persistent delivery channel, the originating session is now subscribed
to the new task's completion/block events automatically. The agent
that dispatched the task gets notified instead of having to poll.

- Gateway sessions (telegram/discord/slack): HERMES_SESSION_PLATFORM +
  HERMES_SESSION_CHAT_ID ContextVars, set by the messaging gateway.
- TUI / desktop sessions: HERMES_SESSION_KEY in the subprocess env.
  The TUI notification poller keys on platform='tui' + chat_id=<key>.
- CLI / cron / test: no persistent channel, no subscription.

Gated by kanban.auto_subscribe_on_create in config.yaml (default True).
Disable to mirror pre-feature behaviour — users who want explicit
kanban_notify-subscribe calls per task can set it to false. This
config gate addresses the design concern that got PR #19718 reverted
upstream (unconditional implicit auto-subscribe on tool-driven
kanban_create was too aggressive for orchestrator users).

HERMES_SESSION_ID is intentionally not a fallback channel — it is
set by ACP/agent subprocess telemetry for every invocation, not just
TUI, so treating it as a notification target would auto-subscribe
every CLI session and re-introduce the over-eager behaviour.

The kanban_create response now includes a 'subscribed' bool so
orchestrators can react if subscription failed (e.g. by falling
back to explicit kanban_notify-subscribe or to polling).

Includes 6 tests covering the gateway / TUI / CLI / partial-context /
gated / add_notify_sub-failure paths. All 90 tests in
test_kanban_tools.py pass; 509 broader kanban tests pass.
2026-06-18 14:10:51 -07:00
..
developer-guide feat(prompt): make context-file truncation limit configurable 2026-06-16 11:28:35 -07:00
getting-started fix(docs): update all install instructions everywhere 2026-06-04 21:07:45 -04:00
guides docs(xai): update default model references to grok-build-0.1 2026-06-16 11:50:17 -07:00
integrations docs(i18n): port deep-audit corrections to zh-Hans mirror (#41104) 2026-06-07 01:57:18 -07:00
reference docs(profile): update clone-from references 2026-06-13 07:33:58 -07:00
user-guide feat(kanban): auto-subscribe calling session on kanban_create 2026-06-18 14:10:51 -07:00
index.mdx fix(docs): update all install instructions everywhere 2026-06-04 21:07:45 -04:00
user-stories.mdx docs(i18n): translate all docs into Simplified Chinese (zh-Hans) (#31942) 2026-05-25 01:47:38 -07:00