Skip to content

draft.md

Latest commit

 

History

History
109 lines (74 loc) · 3.19 KB

draft.md

File metadata and controls

109 lines (74 loc) · 3.19 KB
Raw

tlgr draft

3 operations. Every one takes the global flags (--json, --plain, -a/--account, --results-only, --select, --dry-run, --yes, --no-input, --flood-wait-max, -v) anywhere on the line.

Command Summary
draft clear Clear one draft or every draft
draft list List drafts across chats
draft set Leave a draft in a chat without sending it

draft clear

Clear one draft or every draft.

tlgr draft clear [CHAT] [OPTIONS]

mutating · destructive (needs --yes off a TTY) · idempotent (reports already) · returns DraftCleared

Argument Type Required Meaning
CHAT chat no Chat.
Flag Type Default Meaning
--all flag Clear every draft. 
$ tlgr draft clear @alice --json
Catalog coverage (3 full, 0 partial)

Full: dialogs.draft-clear, messages-core.draft-clear, messages-core.draft-clear-all

draft list

List drafts across chats.

Chat ids are marked ids (-100… for a channel), which is the COR-10 fix: v1 reported the raw entity id here and the marked one elsewhere.

tlgr draft list [OPTIONS]

paginated (LOCAL cursor) · returns Page[Draft]

Flag Type Default Meaning
--chat chat Only this chat's draft.

Pagination is transport-level: --limit/-n, --cursor TOKEN, --all (walked inside the daemon, paced by the account's own rate limiter).

$ tlgr draft list --json
Catalog coverage (3 full, 0 partial)

Full: dialogs.draft-get, dialogs.draft-list, messages-core.draft-list

draft set

Leave a draft in a chat without sending it.

Drafts are server-side and sync to every Telegram client, which is what makes them the handover point between an agent and a person.

tlgr draft set <CHAT> [TEXT] [OPTIONS]

mutating · idempotent (reports already) · returns Draft

Argument Type Required Meaning
CHAT chat yes Chat to leave it in.
TEXT text no Draft body; '-' reads stdin.
Flag Type Default Meaning
--effect text Keep a message effect on the draft.
--entities json Explicit entities.
--no-preview flag Disable the link preview.
--parse md html none
--preview-above flag invert_media.
--preview-url text Preview this URL.
--quote text Quoted fragment.
--reply-to msg-id Draft reply target.
--rich-markdown path Store a rich body (layer 229).
--saved-peer chat Draft inside a saved dialog.
--stdin flag Read the draft from stdin.
--topic msg-id Draft inside a topic. 
$ tlgr draft set @alice "will confirm tomorrow" --json
Catalog coverage (3 full, 0 partial)

Full: dialogs.draft-set, effect.draft, messages-core.draft-set