Add ToggleMouseSonar and AdjustVolume desktop actions

[TalZaccai]

This branch (based on talzacc/action_json_schema) demonstrates how easy it is to add new actions after the architecture refactoring in #2196. Two new actions are added, showcasing the two main patterns described in the README.

ToggleMouseSonar — Option A: Registry Toggle

Enables/disables the Windows "Find my pointer" ring that appears when pressing Ctrl.

Total lines added: 1 (in MouseSettingsHandler.cs)

AddRegistryToggleAction("ToggleMouseSonar", new RegistryToggleConfig(
    @"Control Panel\Mouse", "MouseSonar", "enable",
    OnValue: "1", OffValue: "0", ValueKind: RegistryValueKind.String, DisplayName: "Mouse Sonar"));

No custom handler logic. The AddRegistryToggleAction helper does everything — reads the enable parameter, writes the registry value, returns an ActionResult.

AdjustVolume — Option B: Typed Action with Custom Logic

Adjusts volume relatively ("turn it up a bit") instead of setting an absolute value.

Steps:

1. Define TS schema type in actionsSchema.ts
2. Add handler in AudioActionHandler.cs — reads current volume, applies delta, clamps 0–100, saves for restore

export type AdjustVolumeAction = {
    actionName: "AdjustVolume";
    parameters: {
        direction: "up" | "down";
        amount?: number; // default 10
    };
};

The C# AdjustVolumeParams record is automatically generated by the Roslyn source generator from the .pas.json schema — no manual C# type definition needed.

Test Coverage

• 6 new tests for AdjustVolume (up/down, default amount, clamping, volume save)
• 2 new tests for ToggleMouseSonar (enable/disable registry writes)

[robgruen]

for the registry toggle action, once you set the value does it immediately take effect or do we need to broadcast some sort of WM_SETTINGCHANGED for it to work first?

[robgruen]

BTW, 😍

[TalZaccai]

for the registry toggle action, once you set the value does it immediately take effect or do we need to broadcast some sort of WM_SETTINGCHANGED for it to work first?

It does not take affect immediately, but this might be a wider fix than just this specific toggle, I'll look into fixing it in a separate PR.

[robgruen]

Might be this: WM_SETTINGCHANGE message (Winuser.h) - Win32 apps | Microsoft Learn<https://learn.microsoft.com/en-us/windows/win32/winmsg/wm-settingchange>

…

________________________________ From: Tal Zaccai ***@***.***> Sent: Wednesday, April 15, 2026 11:27 PM To: microsoft/TypeAgent ***@***.***> Cc: Robert Gruen ***@***.***>; Comment ***@***.***> Subject: Re: [microsoft/TypeAgent] Add ToggleMouseSonar and AdjustVolume desktop actions (PR #2201) [https://avatars.githubusercontent.com/u/18443527?s=20&v=4]TalZaccai left a comment (microsoft/TypeAgent#2201)<#2201?email_source=notifications&email_token=AGBS6WN6M2DK7KADDEZHPV34WB4ONA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMRVG44DANRYGA4KM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJNLQOJPWG33NNVSW45C7N5YGK3S7MNWGSY3L#issuecomment-4257806808> for the registry toggle action, once you set the value does it immediately take effect or do we need to broadcast some sort of WM_SETTINGCHANGED for it to work first? It does not take affect immediately, but this might be a wider fix than just this specific toggle, I'll look into fixing it in a separate PR. — Reply to this email directly, view it on GitHub<#2201?email_source=notifications&email_token=AGBS6WN6M2DK7KADDEZHPV34WB4ONA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMRVG44DANRYGA4KM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJNLQOJPWG33NNVSW45C7N5YGK3S7MNWGSY3L#issuecomment-4257806808>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AGBS6WN676GFGEEOSHTFWWD4WB4ONAVCNFSM6AAAAACX24BOTSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DENJXHAYDMOBQHA>. You are receiving this because you commented.Message ID: ***@***.***>