Imported from TrulyNotMalware/CodeCompanion (
infrastructure/src/main/kotlin/dev/notypie/impl/command/slack/AGENTS.md). Install upstream withnpx skills add TrulyNotMalware/CodeCompanion --skill slack. Copyright stays with the author.
infrastructure/impl/command/slack
Purpose
Slack wire DTOs and the small enums/mappers that sit directly on them: the parsed InteractionPayload
and its States, the Events API envelope (SlackEventCallBackRequest / EventCallbackData), the slash
command form body, Block Kit fragments (Block, Element), and the app-mention → InboundCommand mapper.
Nothing here is a Spring bean.
Key Files
| File | Description |
|---|---|
InteractionPayload.kt |
InteractionPayload(type: CommandDetailType, team, user, triggerId, isEnterprise, enterprise?, idempotencyKey, apiAppId, botId, container, channel, responseUrl, states, currentAction, routingExtras = [], privateMetadata?); a hand-written toString() prints every field except responseUrl, routingExtras and privateMetadata (shown as redacted: the reply URL, and on a reschedule / add-participant submit the /meetup list URL in routingExtras[2] and URL-encoded in the metadata; 2026-10-20, docs/wiki/decisions.md #50) — a new field must be added to it by hand; extensions isCompleted(), isPrimary(), isCanceled(). The parser no longer copies the payload's verification token (the SDK payload still parses it) |
States.kt |
States(isSelected = false, type: ActionElementTypes, selectedValue = "", blockId?) — one per form element; blockId is set by the view_submission parser only |
ActionElementTypes.kt |
enum (elementName, isPrimary): APPLY_BUTTON, REJECT_BUTTON, BUTTON are primary ("button"); selects, pickers, CHECKBOX, RADIO_BUTTONS, PLAIN_TEXT_INPUT, UNKNOWN are not |
InteractionTypes.kt |
VIEW_SUBMISSION = "view_submission", BLOCK_ACTIONS = "block_actions" |
Container.kt |
Container(type, messageTime: Instant, isEphemeral, …, viewId?, messageTs?), Channel(id, name), Enterprise(id, name) |
Users.kt |
User(id, userName, name, teamId), Team(id, domain) |
SlackEventCallBackRequest.kt |
Events API envelope (the body's token is not bound: an unknown key, ignored by Jackson 3's default, 2026-10-20): team_id, api_app_id, event: EventCallbackData, type, event_id, event_time, authorizations: List<Authorization>, is_ext_shared_channel, event_context |
EventCallbackData.kt |
app_mention body: client_msg_id?, type, text, user? (absent on mentions posted by a workflow or another app, which carry bot_id; non-null, such a callback failed deserialization and Slack retried the 500), app_id? / bot_id? / bot_profile?, ts: String, thread_ts?, blocks: List<Block> = emptyList() (absent on text-only posts), team, channel, event_ts: Double, channel_type?; plus BotProfile, Icons |
Authorization.kt |
(enterprise_id?, team_id, user_id, is_bot, is_enterprise_install) — is_bot identifies the bot's own user id |
Block.kt / Element.kt |
Block(type, block_id, elements, fields, text: TextElement?); Element(type, text, user_id, image_url, alt_text, verbatim, action_id, value, style: JsonNode?, elements, url, name, channel_id, usergroup_id, range, fallback, indent) — style is a string on buttons and lists but an object on rich_text leaves, and a String type made any bold or code word in a mention fail deserialization; the leaf fields are read when a mention is restored to text, Element.extractText(), sealed TextElement (TextObject / PlainText) with TextValueDeserializer accepting a string or an object |
SlackEventType.kt |
URL_VERIFICATION, EVENT_CALLBACK, APP_MENTION |
SlackMentionMapper.kt |
SlackEventCallBackRequest.toMentionInboundCommand(appId, channelName, actorName): walks the rich_text → rich_text_section, drops the bot's own mention, splits text on single spaces with blanks removed, sets hasCommandStructure A missing user maps to a blank actorId; the mention handler drops app- and workflow-posted mentions before they become commands. restoreMentionText(botId) fills MentionInvocation.text from every rich_text block in order: sections inline, rich_text_preformatted fenced with triple backticks, quotes as > on every line, split with domain/common/splitLineBreaks() so a U+2028/U+2029 inside a quote cannot leave it (trailing line-break characters — LF, CR, VT, FF, NEL, U+2028, U+2029, the private LINE_BREAK_CHARS — are trimmed first, so a quote ending in one leaves no empty > line), lists as - / 1. (indented), and leaves as text, <@id> (bot dropped), label (url) / url (a link with a null or blank url is its label alone, never label (null) or label ()), <#id>, <!subteam^id>, :emoji:, @here, the date fallback, inline-code style in backticks. |
SlashCommandRequestBody.kt |
Slash command form (text → subCommands, channel_id, user_id, trigger_id, …), bound by jsonMapper.convertValue in application/common/SlackRequestParser; the form's token and response_url are not bound (nothing read them; unknown keys are ignored, pinned by SlackControllersTest, 2026-10-20, docs/wiki/decisions.md #50); toInboundCommand() (InboundKind.SLASH, SlashInvocation(TriggerHandle)), subCommandList() |
For AI Agents
Working In This Directory
tsstays aString. It is a message id (thread anchor,chat.updatetarget) and aDoubleround-trip mangles the fixed-point form.event_tsis already aDoubleand is only used by fixtures.InteractionPayload.typecomes fromCommandDetailType.valueOfin the parser; renaming aCommandDetailTypeconstant breaks routing for messages already posted with the old name in their text.isCompleted()has no callers;isPrimary()/isCanceled()gateSlackInteractionHandlerImpl.Enterpriseis declared but never constructed.SlashCommandRequestBody.subCommandList()splits on a single space without dropping blanks, unlike the mention mapper — a double space or a trailing space yields empty tokens for the slash services.- Jackson annotations here are
com.fasterxml.jackson.annotation(retained by Jackson 3) on@field:; the custom deserializer istools.jackson.databind.ValueDeserializer.verbatimandemojidefault totruewhen absent. Elementcarries aFIXMEto become a sealed hierarchy; today every Block Kit element shares one class with nullable fields, so checktypebefore readinguserId/value.- Consumers in
:application:SlackRequestParser,SlackEventController,SlackMentionEventHandlerImpl,SlackInteractionHandlerImpl, and the meeting / standup / CVE slash services.
Testing Requirements
./gradlew :infrastructure:test --tests 'dev.notypie.impl.command.slack.*'ElementTest (string vs object text deserialization) and SlackMentionMapperTest (bot filtering,
tokenizing, hasCommandStructure). Fixtures: testFixtures/.../impl/command/slack/InteractionPayloadCreator,
SlackEventCallBackRequestCreator, .../impl/command/BlockActionPayloadCreator.
Common Patterns
data classDTOs with@field:JsonProperty("snake_case"); optional wire fields are nullable withnulldefaults, required ones non-null.- Boundary mappers are extension functions on the DTO (
toMentionInboundCommand,toInboundCommand).
Dependencies
Internal
domain/command/entity/CommandDetailType,domain/command/inbound/*(InboundCommand,InboundKind,MentionInvocation,SlashInvocation,MessageHandle,TriggerHandle)domain/common/SafeText.kt—splitLineBreaks(quote restore)
External
Jackson annotations, Jackson 3 databind (ValueDeserializer, JsonNode).
