Skip to content

Add the draft/oper-role tag to the oper-tag specification. #607

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sadiepowell wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add the draft/oper-role tag to the oper-tag specification. #607

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
86fda2d
Soft linewrap the oper-tag spec.
sadiepowell May 8, 2026
3c9e9c0
Add the draft/oper-role tag to oper-tag.
sadiepowell May 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 12 additions & 11 deletions extensions/oper-tag.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,34 +7,35 @@ copyrights:
name: "David Schultz"
period: "2022"
email: "me@zpld.me"
-
name: "Sadie Powell"
period: "2026"
email: "sadie@sadiepowell.dev"
---

## Notes for implementing work-in-progress version

This is a work-in-progress specification.

Software implementing this work-in-progress specification MUST NOT use the
unprefixed `oper` tag name. Instead, implementations SHOULD use the
`draft/oper` tag name to be interoperable with other software
implementing a compatible work-in-progress version.
Software implementing this work-in-progress specification MUST NOT use the unprefixed `oper` tag name. Instead, implementations SHOULD use the `draft/oper` tag name to be interoperable with other software implementing a compatible work-in-progress version.

## Description

The `draft/oper-tag` capability causes the server to add a [message tag][] to messages sent by a user who is currently an IRC operator.
The `draft/oper-tag` capability causes the server to add the `draft/oper` and `draft/oper-role` [message tags][] to messages sent by a user who is currently an IRC operator.

The tag MUST be named `draft/oper`. The value of the tag, if specified, MUST identify the operator.
The `draft/oper` tag marks a user as an IRC operator. The value of this tag, if specified, MUST uniquely identify the operator.

The tag MUST be added by the ircd to all commands sent by a user (e.g. PRIVMSG,
MODE, NOTICE, and all others) and SHOULD be added to any numeric replies sent on behalf of the user.
The `draft/oper-role` tag shows the role that a IRC operator has on a network (e.g. NetAdmin). This tag MUST only be sent on messages that have the `draft/oper`tag.

Servers supporting this capability MAY be configured to restrict visibility of this tag or its value.
Servers supporting this capability MAY be configured to restrict visibility of the tags or their values. For users who can see the tags they MUST be added by the IRC server to all commands sent by a user (e.g. `PRIVMSG`, `MODE`, `NOTICE`, etc) and SHOULD be added to any numeric replies sent on behalf of the user (e.g. `RPL_WHOSPCRPL`).

@skizzerz skizzerz Jun 18, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

"numeric replies sent on behalf of the user" is a bit vague. This could perhaps be expanded by including a numeric example in the section below, or the wording could be reworked for clarity.


## Example

Consider that I am identified to the `launchd` operator account while chatting with the `lunchd` nickname. I will send messages to three users with different configured levels of visibility.
Consider that I am identified to the `launchd` operator account while chatting with the `lunchd` nickname. I will send messages to four users with different configured levels of visibility.

@draft/oper=launchd :lunchd PRIVMSG full_access_friend :it's me!
@draft/oper :lunchd PRIVMSG partial_access_friend :you can see I'm an oper
@draft/oper;draft/oper-role=NetAdmin :lunchd PRIVMSG partial_access_friend2 :you can see I'm an oper and my role
:lunchd PRIVMSG unprivileged_friend :don't mind me

[message tag]: ../extensions/message-tags
[message tags]: ../extensions/message-tags