Skip to content

Conversation

@firasrg
Copy link
Member

@firasrg firasrg commented Jan 13, 2026

New Feature: Rewrite Command

The /rewrite command allows users to have their messages rewritten in a clearer, more professional, or better structured form using ChatGPT AI (GPT 5 mini). The rewritten message is displayed as an ephemeral message (visible only to the user), making it perfect for getting quick writing improvements without cluttering the channel where they are.

Usage

/rewrite message:<text> [tone:<style>]

Parameters

  • message (required): The message to rewrite (3-500 characters)
  • tone (optional): The tone/style enum value for the rewrite. Defaults to CLEAR if not provided

Available Tones

  • CLEAR (default): Make the message clear and easy to understand
  • PRO: Use a professional and polished tone
  • DETAILED: Expand with more detail and explanation
  • TECHNICAL: Use technical and specialized language where appropriate

How It Works

  1. You invoke the command with your message and optional tone
  2. ChatGPT analyzes and rewrites the message according to the selected tone
  3. A formatted embed displays both the original and rewritten versions
  4. The response is ephemeral—only visible to you for 15 minutes
  5. You can copy the rewritten text and use it.

Example

image

UPDATE

  • The command name has been changed into /rewrite-msg for consistency with the class in source code.
  • The following is a demo that shows all possible states :

tjbot-rewrite-demo-3

@firasrg firasrg requested a review from a team as a code owner January 13, 2026 21:56
* <p>
* Users can optionally specify a tone/style for the rewrite. If not provided, defaults to CLEAR.
*/
public final class RewriteMsgCommand extends SlashCommandAdapter {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dont abbreviate, RewriteMsgCommand. but to avoid confusion i would try to stick to the actual slash-command name, so just RewriteCommand would be better imo

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about doing that in the beginning, but I found that it may be confusing, since it's possible to be interpreted "rewrite something else, other than a message", so I found it better to write "Message" as abbreviation to avoid verbosity

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but that confusion then also applies to the slashcommand. if u think its confusing then the slash command has to be renamed as well, to /rewrite-msg for example. then the class name is okay again

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/rewrite is perfectly fine

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tj-wazei is this a requirement or an optional suggestion?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it is his opinion as code-reviewer. and now we come to a consensus. i am also fine with rewrite but im still proposing to call the class RewriteCommand in that case

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright, here's the plan:

  • Rename the class to RewriteCommand
  • Restore the original name of the command (/rewrite)

@sonarqubecloud
Copy link

Copy link
Contributor

@tj-wazei tj-wazei left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please see comments. There's a lot of final abuse that does nothing but add clutter to the code. It's best to use final when you need it.


/**
* The implemented command is {@code /rewrite-msg}, which allows users to have their message
* rewritten in a clearer, more professional, or better structured form using ChatGPT AI.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove ChatGPT from the docs as you leak too much implementation details. "using AI" is fine.

* rewritten in a clearer, more professional, or better structured form using ChatGPT AI.
* <p>
* The rewritten message is shown as an ephemeral message visible only to the user who triggered the
* command, making it perfect for getting quick writing improvements without cluttering the channel.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

making it perfect for getting quick writing improvements without cluttering the channel. is unnecessary for code documentation.

* The rewritten message is shown as an ephemeral message visible only to the user who triggered the
* command, making it perfect for getting quick writing improvements without cluttering the channel.
* <p>
* Users can optionally specify a tone/style for the rewrite. If not provided, defaults to CLEAR.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

defaults to CLEAR does not tell a developer what CLEAR is so please can you change this so it makes sense without coupling it to the enum (that isn't even linked).

* <p>
* Users can optionally specify a tone/style for the rewrite. If not provided, defaults to CLEAR.
*/
public final class RewriteMsgCommand extends SlashCommandAdapter {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/rewrite is perfectly fine

*/
public final class RewriteMsgCommand extends SlashCommandAdapter {
private static final Logger logger = LoggerFactory.getLogger(RewriteMsgCommand.class);
public static final String COMMAND_NAME = "rewrite-msg";
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

COMMAND_NAME does not need to be public

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SquidXTV it sounds like you accidently marked this as resolved

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Damn, my bad

final Optional<String> rewrittenMessage = this.rewrite(userMessage, tone);

if (rewrittenMessage.isEmpty()) {
logger.debug("Failed to obtain a response for /rewrite-msg, original message: '{}'",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do not hard code the name here, instead used the constant you defined COMMAND_NAME

logger.debug("Failed to obtain a response for /rewrite-msg, original message: '{}'",
userMessage);
event.getHook()
.editOriginal(
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't good UX. If the user spent a fair bit of time trying to craft their message and an error occurs, they lose it. Instead, return back the original message - an embed might be useful here to add the fact there was an "error" but the user can still copy their original message and send that, should they wish.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FYI discord shows the original prompt on slash commands if u click on the "foo used /bar" that didcord shows in small blue text above the message

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FYI discord shows the original prompt on slash commands if u click on the "foo used /bar" that didcord shows in small blue text above the message

return;
}

final String response = buildResponse(userMessage, rewrittenMessage.orElseThrow(), tone);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unnecessary use of orElseThrow since it will never throw. You are doing an isEmpty check above.

Ideally, this entire block is a good candidate for rewrittenMessage.ifPresentOrElse() if you want that fluency.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

to be fair, if (foo.isEmpty()) ... foo.orElseThrow() is the normal way ur supposed to deal with this in case you are not able to utilize the other, better, methods of the API. (but in this case, try to put the extraction of the content right after the if-check, not 20 lines later)

}

private Optional<String> rewrite(String userMessage, MsgTone tone) {
final String rewritePrompt = buildChatGptPrompt(userMessage, tone);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can inline this String

private Optional<String> rewrite(String userMessage, MsgTone tone) {
final String rewritePrompt = buildChatGptPrompt(userMessage, tone);

return chatGptService.ask(rewritePrompt, tone.displayName, CHAT_GPT_MODEL);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You'll need to update the ask method. The original implementor of the ChatGptService did not make this abstract enough so your request will be mixed with the following prefixed:

For code supplied for review, refer to the old code supplied rather than  rewriting the code. DON'T supply a corrected version of the code.

KEEP IT CONCISE, NOT MORE THAN 280 WORDS

%s

Question: %s

%s
**Rewritten:**
%s""".formatted(toneLabel, userMessage, rewrittenMessage);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dont forget to String#stripIndent when using multi-line strings

If the message is already well-written, provide minor improvements.
Original message:
%s""".formatted(tone.description, userMessage);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dont forget to String#stripIndent when using multi-line strings

@Override
public void onSlashCommand(SlashCommandInteractionEvent event) {
final String userMessage =
Objects.requireNonNull(event.getOption(MESSAGE_OPTION)).getAsString();
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no need for requireNonNull

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the getOption() return is Nullable based on its docs

final OptionData toneOption = new OptionData(OptionType.STRING, TONE_OPTION,
"The tone/style for the rewritten message (default: " + MsgTone.CLEAR.displayName
+ ")",
false);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

y not also make it auto-completeable?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

indeed, it works with autocomplete already without the need to do anything else in code!
tjbot-rewrite-demo-4

Comment on lines +120 to +123
if (toneOption == null) {
logger.debug("Tone option not provided for user: {}, using default CLEAR", userId);
return MsgTone.CLEAR;
}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cannot be null

Copy link
Member Author

@firasrg firasrg Jan 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you're confused here, the call of the method is like this this.parseTone(event.getOption(TONE_OPTION), event.getUser().getId());, where the event.getOption(TONE_OPTION) refers to toneOption argument, and the return of getOption() is marked @Nullable based on docs and source

event.getHook().editOriginal(response).queue();
}

private MsgTone parseTone(@Nullable OptionMapping toneOption, String userId)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are you taking in the userId just for the logs? seems unnecessary

Copy link
Member

@Zabuzard Zabuzard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great stuff. Apart from what the others mentioned, im happy now 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants