- Surfaces that provide explicit mentions still pass; patterns are a fallback.

- Per-agent override: `agents.list[].groupChat.mentionPatterns` (useful when multiple agents share a group).

- Mention gating is only enforced when mention detection is possible (native mentions or `mentionPatterns` are configured).

- Allowlisting a group or sender does not disable mention gating; set that group's `requireMention` to `false` when all messages should trigger.

- Group chat prompt context carries the resolved silent-reply instruction every turn; workspace files should not duplicate `NO_REPLY` mechanics.

- Groups where silent replies are allowed treat clean empty or reasoning-only model turns as silent, equivalent to `NO_REPLY`. Direct chats do the same only when direct silent replies are explicitly allowed; otherwise empty replies remain failed agent turns.

- Discord defaults live in `channels.discord.guilds."*"` (overridable per guild/channel).

- `channels.signal.groupAllowFrom` controls which groups or senders can trigger group replies when `allowlist` is set; entries can be Signal group IDs (raw, `group:<id>`, or `signal:group:<id>`), sender phone numbers, or `uuid:<id>` values.

- `channels.signal.groups["<group-id>" | "*"]` can override group behavior with `requireMention`, `tools`, and `toolsBySender`.

- Use `channels.signal.accounts.<id>.groups` for per-account overrides in multi-account setups.

- Allowlisting a Signal group does not disable mention gating. To process every message in an allowlisted group, set `channels.signal.groups["<group-id>"].requireMention=false` or use the `"*"` group default.

- Runtime note: if `channels.signal` is completely missing, runtime falls back to `groupPolicy="allowlist"` for group checks (even if `channels.defaults.groupPolicy` is set).

## How it works (behavior)

expect(capture.ctx?.From).toBe("group:g1");

});

it("keeps mention gating enabled for group-id allowlists by default", async () => {

const groupHistories = new Map();

const handler = createSignalEventHandler(

createBaseSignalEventHandlerDeps({

cfg: {

messages: {

inbound: { debounceMs: 0 },

groupChat: { mentionPatterns: ["@bot"] },

},

channels: {

signal: {

groupPolicy: "allowlist",

groupAllowFrom: ["g1"],

},

},

},

groupPolicy: "allowlist",

groupAllowFrom: ["g1"],

groupHistories,

historyLimit: 5,

}),

);

await handler(

createSignalReceiveEvent({

dataMessage: {

message: "hello without mention",

groupInfo: { groupId: "g1", groupName: "Test Group" },

attachments: [],

},

}),

);

expect(capture.ctx).toBeUndefined();

expect(dispatchInboundMessageMock).not.toHaveBeenCalled();

expect(groupHistories.get("g1")?.[0]?.body).toBe("hello without mention");

});

it("blocks Signal groups whose id is not listed in groupAllowFrom", async () => {

const handler = createSignalEventHandler(

createBaseSignalEventHandlerDeps({