action
Dispatch actions to manage Telegram sessions, send messages, set reminders, and control bot features through your AI assistant.
Instructions
Universal action dispatcher. Omit type to list all categories. Pass a category (e.g. session) to list sub-paths. Pass a full path (e.g. session/list) to execute. Use help(topic: 'action') for full documentation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Action path to dispatch (e.g. 'session/list', 'profile/voice'). Omit to list all categories. Pass a category name to list sub-paths. | |
| token | No | Session token from action(type: 'session/start'). Token-optional paths: `session/start`, `session/reconnect`, and `session/list` (unauthenticated probe returns SIDs only). Omitting `type` (discovery/category listing) also requires no token. All other paths require a valid token. | |
| name | No | session/start, session/reconnect: Human-friendly session name. | |
| color | No | session/start: Preferred color square emoji hint. session/rename: Color to apply (must be a valid palette emoji). | |
| refresh | No | session/start: When true, collapses first-boot, reconnect-of-live, and re-establish-after-drop into a single call. Pass alongside token to reclaim a live session (returns reused: true). When no session exists for the name, creates a new one (returns reused: false). Omit or false for strict first-boot semantics (current default). activity/file/create: When true, wipes any existing registration for this session (deletes file if TMCP-owned) then proceeds with a fresh create. Response includes replaced: true when a prior registration was wiped, replaced: false when there was none. Omit or false to preserve existing ALREADY_REGISTERED behavior. | |
| new_name | No | session/rename: New alphanumeric name for the session. | |
| voice | No | profile/voice: Voice name to set. Pass empty string to clear. | |
| speed | No | profile/voice: TTS speed multiplier (0.25–4.0). | |
| message_id | No | message/edit, message/delete, message/pin, react, message/get, checklist/update, progress/update, acknowledge: Target message ID. | |
| text | No | message/edit: New text content. reminder/set: Reminder message text. animation/cancel: Replacement text. confirm/*: Prompt shown to user. | |
| keyboard | No | message/edit: Inline keyboard rows. Pass null to remove all buttons. | |
| parse_mode | No | message/edit, animation/cancel: Parse mode for text. 'Markdown' (default) — standard markdown auto-converted; 'MarkdownV2' — raw Telegram MarkdownV2 pass-through (special chars must be manually escaped); 'HTML' — HTML tags. | Markdown |
| disable_notification | No | message/pin: Pin without notifying members. | |
| unpin | No | message/pin: If true, unpin instead of pin. | |
| emoji | No | react: Emoji or semantic alias (e.g. 'thinking', 'done'). Omit to remove reaction. | |
| is_big | No | react: Use big animation (permanent reactions only). | |
| temporary | No | react: Auto-reverts reaction on next outbound action or timeout. | |
| restore_emoji | No | react: Emoji/alias to revert to when temporary reaction expires. | |
| timeout_seconds | No | react: Deadline before auto-restore fires. show-typing: Duration (1–300s, default 20). confirm/*: Seconds to wait for user response before timing out (default 600). | |
| ignore_pending | No | confirm/*: Proceed even if there are unread pending updates (skips the pending check). | |
| callback_query_id | No | acknowledge: ID from the callback_query update. | |
| show_alert | No | acknowledge: Show as dialog alert instead of toast. | |
| url | No | acknowledge: URL to open in the user's browser (for games). | |
| cache_time | No | acknowledge: Seconds the result may be cached client-side. | |
| remove_keyboard | No | acknowledge: Clear the inline keyboard on message_id after answering. Returns MISSING_MESSAGE_ID error if message_id is absent. | |
| target_sid | No | message/route: Session ID to route the message to. session/rename: SID of session to rename (governor only). | |
| topic | No | profile/topic: Short label to prepend to all outbound messages. Pass empty string to clear. | |
| key | No | profile/save, profile/load: Profile key (bare name e.g. 'Overseer'). | |
| voice_speed | No | profile/import: TTS playback speed multiplier (0.25–4.0). | |
| animation_default | No | profile/import: Default animation frame sequence. | |
| animation_presets | No | profile/import: Named animation presets. | |
| reminders | No | profile/import: Reminders to register for this session. Supports time, startup, last_sent, last_received, and schedule (cron-based) triggers. | |
| name_tag | No | name-tag/set or profile/import: Custom name tag string. Replaces the auto-default (<color> <name>). No newlines. Max 64 chars. | |
| cron | No | reminder/schedule: 5-field cron expression (minute hour day month weekday). Example: "0 9 * * *" fires at 9am daily. 6-field expressions are rejected. | |
| tz | No | reminder/schedule: Timezone for the cron expression. Accepts IANA names (e.g. "America/New_York") or aliases: PST/PDT→America/Los_Angeles, MST/MDT→America/Denver, CST/CDT→America/Chicago, EST/EDT→America/New_York, UTC→UTC, GMT→Etc/GMT. Default: "UTC". | |
| trigger | No | reminder/set: When to fire: 'time' (default), 'startup', 'last_sent' (fires after last send), or 'last_received' (fires after last inbound). | |
| mode | No | reminder/set (last_received only): which inbound events reset the clock. "all" (default) = operator + DMs; "operator" = operator only. | |
| only_if_silent | No | reminder/set (last_received only): when true, suppresses the reminder if the agent has already replied since the last qualifying inbound. | |
| delay_seconds | No | reminder/set: Seconds to wait before reminder becomes active (default 0). | |
| recurring | No | reminder/set: Re-arm after firing (default false). | |
| id | No | reminder/set: Optional ID for dedup. reminder/cancel, reminder/disable, reminder/enable, reminder/sleep: Reminder ID to operate on. | |
| until | No | reminder/sleep: ISO-8601 datetime after which the reminder resumes firing (e.g. "2026-06-01T09:00:00Z"). | |
| timeout | No | profile/dequeue-default: Default dequeue timeout in seconds (0–3600). | |
| ms | No | profile/kick-gate: Post-kick lockout window in milliseconds (1000–3600000). Omit to get current value. profile/notify-debounce: Post-notify debounce window in milliseconds (1000–3600000). Omit to get current value. profile/kick-debounce (deprecated): Accepted range 1000–600000; use profile/kick-gate instead. | |
| frames | No | animation/default: Animation frames to set as default or register as preset. | |
| preset | No | react: Named reaction preset (e.g. "processing"). animation/default: Named preset key for registration or recall. | |
| reset | No | animation/default: Reset to built-in default animation. | |
| enabled | No | logging/toggle: true to enable logging, false to disable. | |
| count | No | message/history: Number of events to return (default 20, max 50). | |
| before_id | No | message/history: Return events older than this event ID (page backwards). | |
| version | No | message/get: Version (-1 = current, 0 = original, 1+ = edit history). | |
| filename | No | log/get: Log filename to read. log/delete: Log filename to delete. Omit log/get to list files. | |
| category | No | log/debug: Filter to a single debug category. Valid values: session, route, queue, cascade, dm, animation, tool, health. | |
| since | No | log/debug: Only return entries with id > since (cursor-based pagination). | |
| enable | No | log/debug: Toggle debug logging on/off. | |
| session_id | No | log/trace: Filter to a specific session ID (governor-only for other sessions). | |
| tool | No | log/trace: Filter trace entries to a specific tool name. | |
| since_ts | No | log/trace: Only return trace entries at or after this ISO timestamp. | |
| cancel | No | show-typing: If true, immediately stop the typing indicator. | |
| ticket | No | approve: One-time approval ticket delivered to the governor via dequeue when the session requested approval. | |
| force | No | shutdown: Bypass the pending-message safety guard. session/close: Force-close the last remaining session (bypasses the last-session guard). | |
| reason | No | shutdown/warn: Optional reason for the restart. | |
| wait_seconds | No | shutdown/warn: Optional estimated wait time in seconds before restart. | |
| file_id | No | transcribe: Telegram file_id of voice message. download: Telegram file_id to download. | |
| file_name | No | download: Suggested file name. | |
| mime_type | No | download: MIME type hint from the message. | |
| title | No | checklist/update: Bold heading for the status block. | |
| steps | No | checklist/update: Ordered list of steps with their current statuses. | |
| percent | No | progress/update: Progress percentage (0–100). | |
| subtext | No | progress/update: Optional italicized detail line below the bar. | |
| width | No | progress/update: Bar width in characters (default 10). | |
| commands | No | commands/set: Slash commands to register. Pass [] to clear the menu. | |
| scope | No | commands/set: "chat" scopes commands to active chat (default). "default" sets globally. | |
| file_path | No | activity/file/create, activity/file/edit: Absolute path to the activity file. Omit to let TMCP generate one in data/activity/. | |
| child_token | No | session/revoke-child: Dispatch token of the child session to revoke (the `token` field returned by session/spawn-child). Either the spawning parent OR the child itself may call this. Self-revocation is the preferred exit path: sub-agent emits EXIT_STATUS: then calls this with its own dispatch token. | |
| child_sid | No | child/forward: SID of the target child session to forward a message to. | |
| message | No | child/forward: Text message to inject into the child session's dequeue queue as an operator-forwarded message. | |
| event_type | No | child/notify: Caller-defined event type (max 64 chars, alphanumeric + '/' + '_'). | |
| payload | No | child/notify: Optional JSON-serializable object delivered verbatim to the parent session. | |
| child_capability | No | session/spawn-child: Capability level for the spawned child session (default: 'gather'). |