package telegram import ( "context" "fmt" "strings" "github.com/go-telegram/bot" "github.com/go-telegram/bot/models" ) type commandSpec struct { Command string Description string Usage string } // gatewayCommandSpecs is the single source of truth for both Telegram's // published command menu and /help. Keeping the discoverability surfaces // together prevents a newly registered command from being omitted from help. var gatewayCommandSpecs = []commandSpec{ {Command: "status", Description: "Show health: queue depth, broker, and the last chat-model call", Usage: "/status"}, {Command: "tasks", Description: "Show your tasks: state, stage, age, parked reason", Usage: "/tasks"}, {Command: "version", Description: "Show installed Archie versions", Usage: "/version"}, {Command: "update", Description: "Check for Archie updates", Usage: "/update"}, {Command: "model", Description: "Choose a provider and model or switch directly", Usage: "/model [provider/model]"}, {Command: "personality", Description: "Choose a communication style", Usage: "/personality [name]"}, {Command: "spawn", Description: "Create a tracked task", Usage: "/spawn [identity=name] [repo=owner/name] [workflow=name] "}, {Command: "settings", Description: "Inspect or change runtime settings", Usage: "/settings [list|get <kind>|set <kind> <field>=<value> ...]"}, {Command: "cancel", Description: "Cancel a queued or waiting task", Usage: "/cancel [identity=name] <task-id>"}, // /approve and /deny are Telegram's own dangerous-command approval surface: // dangerous.go lists the pending commands and the inline buttons decide. The // shared command specs use /approve for task approval instead, and Telegram's // exact-match handler shadows that path, so /help must describe the Telegram // meaning. Reconciling the split is archie-core-ho86; do not copy the shared // task-approval copy here. {Command: "approve", Description: "Show pending dangerous commands to approve", Usage: "/approve"}, {Command: "deny", Description: "Show pending dangerous commands to deny", Usage: "/deny"}, {Command: "start", Description: "Confirm that Archie is running", Usage: "/start"}, {Command: "new", Description: "Start a fresh session, clearing conversation history", Usage: "/new [title]"}, {Command: "reset", Description: "Alias for /new", Usage: "/reset [title]"}, {Command: "topic", Description: "List or switch sessions for this channel", Usage: "/topic [off|help|<session-id>]"}, {Command: "retry", Description: "Replay the last message with a fresh reply", Usage: "/retry"}, {Command: "undo", Description: "Remove the last N messages from the session", Usage: "/undo [N]"}, {Command: "title", Description: "Show or set the current session's title", Usage: "/title [name]"}, {Command: "branch", Description: "Create a child session that inherits the current history", Usage: "/branch [name]"}, {Command: "fork", Description: "Alias for /branch", Usage: "/fork [name]"}, {Command: "compress", Description: "Compress the current session's context", Usage: "/compress [here [N]|focus <topic>|--preview|--dry-run]"}, {Command: "compact", Description: "Alias for /compress", Usage: "/compact [here [N]|focus <topic>|--preview|--dry-run]"}, {Command: "whoami", Description: "Show the active identity and model", Usage: "/whoami"}, {Command: "profile", Description: "Show the active identity's profile", Usage: "/profile"}, {Command: "sessions", Description: "List this channel's sessions", Usage: "/sessions"}, {Command: "resume", Description: "Switch to a session by id or unique prefix", Usage: "/resume <session-id>"}, {Command: "delete", Description: "Permanently delete a session and its history", Usage: "/delete <session-id>"}, {Command: "agents", Description: "List tasks currently being worked", Usage: "/agents"}, {Command: "rollback", Description: "Restore a filesystem checkpoint", Usage: "/rollback [number]"}, {Command: "stop", Description: "Terminate a background process", Usage: "/stop <process-name>"}, {Command: "restart", Description: "Reload Archie and its configuration", Usage: "/restart"}, {Command: "help", Description: "See what Archie can do", Usage: "/help"}, } var gatewayCommands = func() []models.BotCommand { commands := make([]models.BotCommand, 0, len(gatewayCommandSpecs)) for _, spec := range gatewayCommandSpecs { commands = append(commands, models.BotCommand{ Command: spec.Command, Description: spec.Description, }) } return commands }() func gatewayHelpText() string { var help strings.Builder help.WriteString("🤖 **Archie**\n\n") help.WriteString("Send a message to chat with Archie. Replies stream into Telegram as they are generated.\n\n") help.WriteString("**Commands**\n") for _, spec := range gatewayCommandSpecs { fmt.Fprintf(&help, "`%s`\n%s\n\n", spec.Usage, spec.Description) } return strings.TrimSpace(help.String()) } // commandScopes are the scopes the menu is published to. // // Telegram resolves a chat's menu by scope specificity, not recency: a // list set on all_private_chats wins over the default scope in every DM. // Publishing only to the default scope therefore leaves the bot showing // whatever a previous owner of the token registered against the narrower // scopes -- state that lives on Telegram's side and survives redeploys, // rewrites and migrations. Writing every scope we care about overwrites // those leftovers instead of being shadowed by them. var commandScopes = []models.BotCommandScope{ &models.BotCommandScopeDefault{}, &models.BotCommandScopeAllPrivateChats{}, &models.BotCommandScopeAllGroupChats{}, } // registerCommands publishes the command menu to every scope. A failure // here costs discoverability, not function -- every command still works // when typed -- so it is logged rather than treated as fatal, and one // failing scope does not stop the others. func (g *Gateway) registerCommands(ctx context.Context, b *bot.Bot) { for _, scope := range commandScopes { if _, err := b.SetMyCommands(ctx, &bot.SetMyCommandsParams{ Commands: gatewayCommands, Scope: scope, }); err != nil { g.log.Warn("set command menu failed", "scope", fmt.Sprintf("%T", scope), "error", err) continue } } g.log.Info("command menu registered", "commands", len(gatewayCommands), "scopes", len(commandScopes)) }