telegram-bot::__on-approval-gate-worker
Internal: track approval-gate worker add/remove.
- operationstring
- sourceunknown
- stagestring
- workerstring
- okbooleanrequired
telegram-bot
v0.3.8Telegram bridge to the harness stack — polling or webhook ingress, live message edits, approvals, and configurable verbosity.
Install
bash
iii trigger compose::add worker=telegram-botRun in your project with the iii engine running. Exact versions are immutable and digest-pinned.
Functions11
Function
telegram-bot::notify
Send a message to the Telegram chat bound to a session. Use this to reach the user out-of-band (e.g. a scheduled reminder or when a long task finishes); the message is delivered only to that session's chat.
- parse_modestring
Optional Telegram `parse_mode` (`MarkdownV2` / `HTML`). When set, `text` is sent verbatim with that mode instead of being auto-formatted.
- session_idstringrequired
The session whose chat receives the message. Must be a session this bot created (e.g. the `session_id` from the channel-context prompt).
- textstringrequired
The message text. Markdown is auto-formatted for Telegram unless `parse_mode` is set explicitly. Long text is split across messages.
- deliveredbooleanrequired
- message_idsinteger[]· int64required
Telegram message ids of the (possibly chunked) messages sent.
telegram-bot::on-config-change
Internal: reload telegram-bot configuration from the authoritative store on change.
Empty object
- okbooleanrequired
telegram-bot::on-message-added
Create a Telegram message for each new assistant or function_result entry.
- entry_idstringrequired
- messageany ofany of (2)Variant 1
- contentone of[]
Show 4 nestedHide nested
one of (4)Variant 1- textstringrequired
- typestringrequiredenum text
Variant 2- textstringrequired
- typestringrequiredenum thinking
Variant 3- argumentsunknownrequired
- function_idstringrequired
- idstringrequired
- typestringrequiredenum function_call
Variant 4- typestringrequiredenum other
- rolestringrequired
Variant 2valuenull - parent_idstring
Parent entry in the session chain (authoritative append order).
- session_idstringrequired
- timestampinteger· int64
Append time in ms; used as the per-entry ordering key.
- okbooleanrequired
telegram-bot::on-message-updated
Stream assistant edits into Telegram, throttled by revision.
- entry_idstringrequired
- messageobjectrequired
- contentone of[]one of (4)Variant 1
- textstringrequired
- typestringrequiredenum text
Variant 2- textstringrequired
- typestringrequiredenum thinking
Variant 3- argumentsunknownrequired
- function_idstringrequired
- idstringrequired
- typestringrequiredenum function_call
Variant 4- typestringrequiredenum other
- rolestringrequired
- revisioninteger· uint64requiredmin 0
- session_idstringrequired
- timestampinteger· int64
Mutation time in ms; refines the per-entry ordering key (min wins).
- okbooleanrequired
telegram-bot::on-pending-created
Send an inline approval keyboard when a function call is held.
- arguments_excerptunknown
- function_call_idstringrequired
- function_idstringrequired
- session_idstringrequired
- okbooleanrequired
telegram-bot::on-pending-resolved
Clear the approval prompt when a held call is resolved.
- function_call_idstringrequired
- outcomestringrequired
- session_idstringrequired
- okbooleanrequired
telegram-bot::on-status-changed
Observe session status changes.
- session_idstringrequired
- statusstringrequired
- status_reasonstring
- okbooleanrequired
telegram-bot::on-turn-completed
Finalize streaming, drain FIFO queue, and post turn outcome toasts.
- reasonstring
- result_errorstring
- session_idstringrequired
- statusstringrequired
- terminalboolean
`false` while the session still owns an armed wake: the run continues and a later turn carries the real outcome. Missing (legacy harness) → terminal.
- turn_idstringrequired
- okbooleanrequired
telegram-bot::set-webhook
Register the Telegram webhook URL from configuration.
Empty object
- okbooleanrequired
- urlstringrequired
telegram-bot::webhook
Receive Telegram updates; route commands, messages, and callbacks.
- bodyunknown
- headersobject
- okbooleanrequired
Triggers0
No triggers registered