Skip to content

Add PluralKit style command (limited) handler an proxy recognition#550

Merged
dozro merged 12 commits intoSableClient:devfrom
dozro:feat/compat/pluralkit
Mar 28, 2026
Merged

Add PluralKit style command (limited) handler an proxy recognition#550
dozro merged 12 commits intoSableClient:devfrom
dozro:feat/compat/pluralkit

Conversation

@dozro
Copy link
Copy Markdown
Member

@dozro dozro commented Mar 26, 2026 •
edited
Loading

Description

Fixes #427
Fixes #425 (you can use shorthands, instead of /usepmp)

PluralKit Compatibility and Per-Message Profile Enhancements

  • Added limited compatibility for PluralKit-style (pk;member) commands, allowing users to interact with PMPs using familiar PK syntax.
  • Introduced shorthand syntax for sending messages with a Persona, such as ✨:test, and an option to enable/disable this in settings.
  • Added a new settings section (PKCompatSettings) in the Persona profile page to toggle PK command compatibility and shorthand proxying.

Command Handling Improvements

  • Updated /addpmp and /usepmp command parsing to use regular expressions, fixing syntax issues and clarifying usage. The /usepmp command now has a new syntax and properly resets room associations when requested.
  • Added a new /pmpproxy command to associate a proxy with a profile, and integrated feedback for unsupported flags in /usepmp.

Data Model and Utility Updates

  • Expanded the per-message profile data model to support compatibility versions and proxy associations, including new type definitions and parsing utilities.

These changes collectively improve the user experience for those using per-message profiles and PluralKit-style workflows, and provide more flexible and robust command handling.

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings

AI disclosure:

  • Partially AI assisted (clarify which code was AI assisted and briefly explain what it does).
  • Fully AI generated (explain what all the generated code does in moderate detail).

no AI was used in the creation of this PR

dozro added 11 commits March 18, 2026 15:05
@dozro
stub: add PluralKit command message handler and data models
a842bce
@dozro
Merge branch 'dev' into feat/compat/pluralkit
d1c2ab8
@dozro
feat(pk-integration): added some simple, member related commands peop…
3f706fe 
…le might expect when comming from pluralkit
@dozro
feat(pkit-compat): some steps towards recognizing proxies, not entire…
5f22d86 
…ly there yet
@dozro
fix(pk-compat-proxy): extracting message from proxied message
ba18d25
@dozro
fix(pmp-command): fix usepmp command handling and description
75d0145
@dozro
feat(PMP-PK): added more options (removing shorthand,...) and documen…
2a4fd48 
…tation
@dozro
fix(PMP-Command): fix the syntax handling of pmp related command
155ac64
@dozro
Merge branch 'dev' into feat/compat/pluralkit
523fcbb
@dozro
docs(PMP-Command): adjusted the description of /usepmp and also add…
bc8e964 
…ed a changeset
@dozro
Merge branch 'feat/compat/pluralkit' of https://github.com/dozro/Sable2…
7dfafc3 
… into feat/compat/pluralkit
@dozro
Copy link
Copy Markdown
Member Author

dozro commented Mar 27, 2026

.changeset/fix_command_handling_for_usepmp.md and .changeset/fix_pmp_commands.md are maybe the same content just different phrasing 🤔

@dozro dozro marked this pull request as ready for review March 27, 2026 01:38
@dozro dozro requested review from 7w1 and hazre as code owners March 27, 2026 01:38
7w1
7w1 approved these changes Mar 28, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@7w1 7w1 left a comment

Choose a reason for hiding this comment

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

Didn’t test heavily but code lgtm

@dozro dozro added this pull request to the merge queue Mar 28, 2026
Merged via the queue into SableClient:dev with commit e0a666c Mar 28, 2026
9 checks passed
@sable-release-bot sable-release-bot bot mentioned this pull request Mar 28, 2026
Merged
@dozro dozro deleted the feat/compat/pluralkit branch March 28, 2026 15:26
github-merge-queue bot pushed a commit that referenced this pull request Mar 28, 2026
@7w1
chore: prepare release 1.13.0 (#518)
709a9a9 
> [!IMPORTANT]
> Merging this PR will create a new release.

## Features

* Add ability to click on usernames in member and state events to view
user info ([#536](#536) by
@thundertheidiot)
* Add black theme ([#437](#437)
by @Elec3137)
* added a limited compatibility with `pk;member` commands
([#550](#550) by @dozro)
* Add /location sharing command, and a /sharemylocation command.
([#509](#509) by @nushea)
* added option to use shorthands to send a message with a Persona, for
example `✨:test` ([#550](#550)
by @dozro)
* Add quick reply keybinds by using <kbd>ctrl</kbd>+<kbd>up</kbd> /
<kbd>ctrl</kbd>+<kbd>down</kbd> you can now cycle through the message
you are replying to with keybinds
([#524](#524) by @CodeF53)
* Adds a `/html` command to send HTML messages
([#560](#560) by @Vespe-r)
* Add room abbreviations with hover tooltips: moderators define
term/definition pairs in room settings; matching terms are highlighted
in messages. ([#514](#514) by
@Just-Insane)
* Add support for timestamps, playlists and youtube music links for the
youtube embeds ([#534](#534) by
@thundertheidiot)
* Add settings sync across devices via Matrix account data, with JSON
export/import ([#515](#515) by
@Just-Insane)

## Fixes

* Add detailed error messages to forwarding failures.
([#532](#532) by @7w1)
* Cap unread badge numbers at `1k+`, and something extra :)
([#484](#484) by @hazre)
* Fix scroll-to-bottom after room navigation, timeline pagination
reliability, and URL preview deduplication.
([#529](#529) by @Just-Insane)
* Fixes the most recent pmp message in encrypted rooms not consistently
rendering the pmp and not grouping with previous pmps.
([#526](#526) by @7w1)
* fixed sending sticker and attachments while having a persona selected
([#525](#525) by @dozro)
* Fix push notifications missing sender/room avatar and showing stale
display names when using event_id_only push format.
([#551](#551) by @Just-Insane)
* Sanitize formatted reply previews before rendering to prevent unsafe
HTML from being parsed in reply snippets.
([#569](#569) by @Just-Insane)
* Fix broken link to Sliding Sync known issues — now points to
#39 instead of the old repository.
([#519](#519) by @Just-Insane)
* Fix service worker authenticated media requests returning 401 errors
after SW restart or when session data is missing/stale.
([#516](#516) by @Just-Insane)
* rephrased the command describtion for `/usepmp` and made `/usepmp
reset` actually reset the room association of the pmp
([#550](#550) by @dozro)
* Fix confusing ui with `Client Side Embeds in Encrypted Rooms` setting
([#535](#535) by
@thundertheidiot)
* fix forwarding metadata by removing the `null` value
([#540](#540) by @dozro)
* fix forwarding issue for users on synapse homeservers, by removing the
relation ([#558](#558) by
@dozro)
* fixed the syntax issues regarding `/addpmp` and `usepmp` (note that
the syntax for `/usepmp` has changed)
([#550](#550) by @dozro)
* fix the display of jumbo emojis on messages sent with a persona
([#530](#530) by @dozro)
* Fix sidebar notification badge positioning so unread and unverified
counts align consistently.
([#484](#484) by @hazre)
* Use the browser's native compact number formatting for room and member
counts. ([#484](#484) by
@hazre)
* fix(sentry): scrub percent-encoded Matrix IDs and opaque base64url
tokens from Sentry URLs
([#531](#531) by @Just-Insane)

## Notes

* new/changed bios will now also be saved in the format MSC4440 expects
([#559](#559) by @dozro)
* moved the setting for filtering pronouns by language from experimental
to the appearance setting
([#521](#521) by @dozro)
@Astralchroma Astralchroma mentioned this pull request Mar 28, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@7w1 7w1 7w1 approved these changes

@hazre hazre Awaiting requested review from hazre hazre is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Command to send single message without PMP PMP prefix

2 participants

@dozro @7w1