Skip to main content

Module tasks

Module tasks 

Source
Expand description

Plugin long-running task notification types and parser.

Phase B Phase 3 contract — see docs/plans/2026-05-03-extension-contracts-for-rich-plugins.md.

Plugins push spontaneous JSON-RPC notifications for long-running tasks (downloads, rebuilds, indexing) outside the slash-command request/response cycle. Method names: task.start, task.update, task.log, task.done.

Wire shapes (params per method):

  • task.start: { id, label, kind: "download"|"rebuild"|"generic" }
  • task.update: { id, current?: u64, total?: u64, message?: string }
  • task.log: { id, line }
  • task.done: { id, error?: string|null }

Enums§

TaskEvent
Parsed task notification.
TaskKind
Coarse classification of a task; affects how it’s rendered.

Functions§

is_task_method
Returns true if method is one of the recognised task notifications.
parse_task_event
Parse a task.* notification given the JSON-RPC method and params.