79:Td63,Today `/storytime` is the only way to start a story. This adds a second entry point: mentioning the bot in a channel starts one. ``` @Storytime Bot @Storytime Bot -t Pirates -t Space @Storytime Bot --video --style claymation ``` ## Approach A mention arrives as an `app_mention` event on the existing `/api/slack/webhook` endpoint, which already handles the Events API. Unlike a slash command it carries no `trigger_id`, so the configuration modal cannot be opened from one. The mention therefore starts the story directly: the bot's own mention is stripped out of the text and the remainder is parsed with `parseStorytimeArgs`, the same flags the slash command accepts, with the usual defaults for anything left out. Other words in the message land in `arg`'s positional bucket and are ignored, so `@Storytime Bot let's write something` starts a story with the defaults. Only the bot's own mention is removed, identified from `authorizations[0].user_id`, so `-t "a tale for <@U999>"` keeps the other user intact. Without `authorizations`, every user mention is dropped instead. Existing behavior is untouched: the slash command still opens the modal, the modal still starts the story on submit, and thread replies still resume the story hook. ## Guards - **Mentions inside a thread do not start a story.** Replies in a story thread already continue that story through the `message` event; starting here would spawn a second story in the channel while the first is still running. Only top-level mentions (no `thread_ts`, or `thread_ts === ts`) start one. - **Redelivered events are ignored.** Slack retries when it doesn't see a 200 within three seconds, which a cold start can hit even though the handler ran. A mention carrying `x-slack-retry-num` is skipped rather than starting a duplicate story. - **Mentions posted by a bot are ignored**, the same way thread messages from bots already are. - **Gateway transcripts stay off**, matching the slash command, whose modal leaves the field out — without this, `@Storytime Bot --transcripts` would be the one way to turn them on from Slack, contradicting the README. The story starts inside `waitUntil` so Slack gets its acknowledgement immediately. Invalid flags and start failures are reported to the mentioning user with an ephemeral message, matching the slash command and modal paths. ## Slack app configuration Mention handling needs the `app_mentions:read` scope and the `app_mention` event subscription on the same Request URL the `message.channels` subscription already uses. Existing installations must add both and reinstall; until they do, nothing changes for them. Both are documented in the README, along with the new section describing the mention flow. ## Tests `pnpm test`: 159 passing, up from 135. New `app/api/slack/webhook.test.ts` covers the mention path end to end through the route — defaults, flags, surrounding chatter, each guard above, and the error paths — plus the thread-reply hook resume, which had no coverage before. New `lib/slack-mention.test.ts` covers mention stripping, including labeled mentions, other users, and channel links. `pnpm build`, `pnpm lint`, and `tsc --noEmit` are clean. ## Not covered Starting a story *inside* a thread. `storytime()` posts to a channel and has no thread parameter, so that would be a larger change. 🤖 Generated with [Claude Code](https://claude.com/claude-code) 7a:Tfb6,The latest updates on your projects. Learn more about [Vercel for GitHub](https://vercel.link/github-learn-more). | Project | Deployment | Actions | Updated | |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------------------------------------------------------------------------------------------- | | [storytime\-slackbot](https://vercel.com/vercel-labs/storytime-slackbot) | ![Ready](https://cdn.trylle.com/media/images/c6f97f6a2d9a50bb079b9c2120bcabc5?key=Aag9OPWPryCkgfLUMIUiriowtODh4hqHlmlzdftFmfU8NF62NmcRWEZYaAzSgjXFV7CRHFmtwIUXQzGW%2FMiYFGynEBRM2ZcoaM4U6O0OS8PmNZa7IXMfoNTDcz9NEzKc17c%2BcAPOWyxWJVBjzZRRTanNPzdCPpYzbuN8NGKPs87X) [Ready](https://vercel.com/vercel-labs/storytime-slackbot/6qpeZSUp5oQgLGLxiqKadeDaFKDc) | [Preview](https://storytime-slackbot-git-slackbot-mention-trigger.labs.vercel.dev), [v0](https://v0.app/chat/api/open?vercelProjectId=prj_yYJVWe3zDWp7E9fcZUZ6TJNHuJ1Z&gitBranch=slackbot-mention-trigger&vercelTeamId=team_nO2mCG4W8IxPIeKoSsqwAxxB&utm_source=pr-comment-table) | Oct 10, 2026 12:14am UTC | 7b:T520,Start a story when the bot is @-mentioned The `/storytime` slash command is the only way to start a story today. A mention has no `trigger_id`, so the configuration modal can't be opened from one; instead, handle the `app_mention` event by parsing the text around the mention with the same flags the slash command accepts and starting the workflow directly, falling back to the defaults. Slash command, modal, and thread-reply handling are unchanged. Guards keep a mention from starting a story twice or in the wrong place: - Mentions inside a thread are ignored. Replies in a story thread already continue that story through the `message` event, so starting here would spawn a second story in the channel. - Redelivered events (`x-slack-retry-num`) are ignored, so a slow acknowledgement doesn't produce a duplicate story. - Mentions posted by a bot are ignored, as thread messages already are. Gateway transcripts stay off for mention-started stories, matching the slash command, whose modal drops the field. The start runs in `waitUntil` so Slack gets its 200 within three seconds; invalid flags and start failures are reported to the user ephemerally. Co-Authored-By: Claude Opus 5 (1M context) Co-Authored-By: Nathan Rajlich <71256+TooTallNate@users.noreply.github.com> 63:["$","$L76",null,{"entries":[{"key":["platform",{"userId":"anon"},"pulls","page",{"owner":"vercel-labs","repo":"storytime-slackbot","pullNumber":15}],"data":{"repositoryId":"4782","detail":{"author":{"avatarUrl":"https://cdn.trylle.com/media/images/3cc86398e05ecb325d6a5d7535ba1289?key=ARQEHtpVWzjNOtEdk5nUrudCq%2FYkZk61wsl%2FVh8xGQAWYk8pyk4R0cW2TooV5uYqSCGd5vBwY%2BCmTmRw2ejp2arlvGeWrc8y8mPhJAg5mN5d%2FtAEE5mxmrDNTTQW0RJZ0KuRHITLnV9EFilzzqbQzuT5hR9XXJIV60mGc%2BMRdLmV1ZlK647Crg%3D%3D","externalProvider":"github","login":"TooTallNate","type":"User","url":"https://github.com/TooTallNate"},"authorId":"71256","baseRefName":"main","closedAt":null,"comments":2,"createdAt":"2026-10-10T00:13:41Z","headRefName":"slackbot-mention-trigger","id":"4930697","isDraft":false,"labels":[],"number":15,"repository":{"name":"storytime-slackbot","owner":"vercel-labs","provider":"forgejo"},"state":"open","title":"Start a story when the bot is @-mentioned","updatedAt":"2026-10-10T00:14:01Z","url":"https://trylle.com/vercel-labs/storytime-slackbot/pulls/15","body":"$79","additions":460,"deletions":5,"changedFiles":5,"commits":1,"reviewComments":1,"headSha":"7ea08a9378f46c22b175bc9563151358e4822473","baseSha":"72b6210f39f79471c38cfbd9cc942c35ea90cb5d","headRepoOwner":"vercel-labs","headRepoName":"storytime-slackbot","isMerged":false,"mergeCommitSha":null,"mergedBy":null,"mergeable":true,"mergeableState":"clean","conflictingFiles":null,"requestedTeams":[],"requestedReviewers":[],"graphqlId":"issue:15"},"comments":[{"id":26841610,"graphqlId":"26841610","body":"$7a","createdAt":"2026-10-10T00:13:46Z","author":{"avatarUrl":"https://cdn.trylle.com/media/images/bd21565b4b886e5cef0db32c7f0344af?key=Ac2%2Bksi1LIlNHkTtZAwXv6tt09t6J3yi307LJjxqX4WJV7V2s6%2BI0Envy0ptnh0BgWnFPJBIWHoaJP7O2PIdz4%2FDyORhprU5SMAs88biowmDdp5P5wEqJwK9hocc32DyIwf1dkRFfPk7p4jIYoYYJT1K1dXJsF971VaTxvZB7cj8CL47nQE27ziOhg%3D%3D","externalProvider":"github","login":"vercel[bot]","type":"Bot","url":"https://github.com/apps/vercel"}}],"commits":[{"sha":"7ea08a9378f46c22b175bc9563151358e4822473","message":"$7b","createdAt":"2026-10-10T00:13:16Z","author":{"avatarUrl":"","login":"","name":"vercel[bot]","type":"User","url":""},"verification":{"verified":false,"reason":"gpg.error.no_gpg_keys_found"}}],"events":[{"id":26841611,"event":"reviewed","createdAt":"2026-10-10T00:13:47Z","actor":{"avatarUrl":"https://cdn.trylle.com/media/images/cc388f5bd11d20eabcb149edb1a625a8?key=AQN9Yde%2FA1zhxhpyqcQF8eUTlbD8%2BXJrFXVFYXqT%2Bk5vC2VnF6wPjQdBWj1QtDjoh0Fb2%2B02nTytx5OUGsOBhEMB5EjvAA7Qe3VXuv370TPY5YjMAc6rHQV3%2Fz4LbbumgprNtK1ebIZY8iRLOVcofRQk3yrivns7hvOIcPNs90aFjGVADxCDpB8WCOI%3D","externalProvider":"github","login":"copilot-pull-request-reviewer[bot]","type":"Bot","url":"https://github.com/apps/copilot-pull-request-reviewer"},"reviewId":3599245,"reviewState":"COMMENT","body":"Copilot was unable to review this pull request because the user who requested the review has reached their quota limit."}],"reviews":[{"id":3599245,"state":"COMMENT","author":{"avatarUrl":"https://cdn.trylle.com/media/images/cc388f5bd11d20eabcb149edb1a625a8?key=AQN9Yde%2FA1zhxhpyqcQF8eUTlbD8%2BXJrFXVFYXqT%2Bk5vC2VnF6wPjQdBWj1QtDjoh0Fb2%2B02nTytx5OUGsOBhEMB5EjvAA7Qe3VXuv370TPY5YjMAc6rHQV3%2Fz4LbbumgprNtK1ebIZY8iRLOVcofRQk3yrivns7hvOIcPNs90aFjGVADxCDpB8WCOI%3D","externalProvider":"github","login":"copilot-pull-request-reviewer[bot]","type":"Bot","url":"https://github.com/apps/copilot-pull-request-reviewer"},"body":"Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.","submittedAt":"2026-10-10T00:13:47Z","official":false}],"stackEvents":[],"commentPagination":{"totalCount":2,"perPage":30,"loadedPages":[1]},"eventPagination":{"loadedPages":[1],"hasMore":false},"headRefDeleted":false},"fetchedAt":1794570396201}],"children":"$L7c"}] 65:null 6c:[["$","title","0",{"children":"Commits · Start a story when the bot is @-mentioned · vercel-labs/storytime-slackbot | Trylle"}],["$","meta","1",{"name":"description","content":"Commits on Start a story when the bot is @-mentioned (#15) in vercel-labs/storytime-slackbot."}],["$","meta","2",{"name":"application-name","content":"Trylle"}],["$","link","3",{"rel":"manifest","href":"/manifest.json","crossOrigin":"$undefined"}],["$","meta","4",{"name":"keywords","content":"Commits · Start a story when the bot is @-mentioned · vercel-labs/storytime-slackbot, vercel-labs/storytime-slackbot, vercel-labs/storytime-slackbot repository, storytime-slackbot, TypeScript repository, source code, trylle, agent-native git platform, git platform for agents and humans, git platform for ai agents, coding agent pull requests, ai code review, repository automation, stacked pull requests, two-way github sync, github-compatible actions, try cli"}],["$","meta","5",{"name":"robots","content":"index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1"}],["$","meta","6",{"name":"mobile-web-app-capable","content":"yes"}],["$","meta","7",{"name":"googlebot","content":"index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1"}],["$","meta","8",{"name":"twitter:domain","content":"trylle.com"}],["$","meta","9",{"name":"twitter:url","content":"https://trylle.com/vercel-labs/storytime-slackbot/pulls/15/commits"}],["$","link","10",{"rel":"canonical","href":"https://trylle.com/vercel-labs/storytime-slackbot/pulls/15/commits"}],["$","meta","11",{"name":"format-detection","content":"telephone=no"}],["$","meta","12",{"name":"mobile-web-app-capable","content":"yes"}],["$","meta","13",{"name":"apple-mobile-web-app-title","content":"Trylle"}],["$","meta","14",{"name":"apple-mobile-web-app-status-bar-style","content":"black-translucent"}],["$","meta","15",{"property":"og:title","content":"Commits · Start a story when the bot is @-mentioned · vercel-labs/storytime-slackbot | Trylle"}],["$","meta","16",{"property":"og:description","content":"Commits on Start a story when the bot is @-mentioned (#15) in vercel-labs/storytime-slackbot."}],["$","meta","17",{"property":"og:url","content":"https://trylle.com/vercel-labs/storytime-slackbot/pulls/15/commits"}],["$","meta","18",{"property":"og:site_name","content":"Trylle"}],["$","meta","19",{"property":"og:locale","content":"en_US"}],["$","meta","20",{"property":"og:image","content":"https://trylle.com/api/og.png?kind=repo&owner=vercel-labs&repo=storytime-slackbot"}],["$","meta","21",{"property":"og:image:secure_url","content":"https://trylle.com/api/og.png?kind=repo&owner=vercel-labs&repo=storytime-slackbot"}],["$","meta","22",{"property":"og:image:type","content":"image/png"}],["$","meta","23",{"property":"og:image:width","content":"1200"}],["$","meta","24",{"property":"og:image:height","content":"630"}],["$","meta","25",{"property":"og:image:alt","content":"vercel-labs/storytime-slackbot repository preview on Trylle"}],["$","meta","26",{"property":"og:type","content":"website"}],["$","meta","27",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","28",{"name":"twitter:site","content":"@trylle"}],["$","meta","29",{"name":"twitter:title","content":"Commits · Start a story when the bot is @-mentioned · vercel-labs/storytime-slackbot | Trylle"}],["$","meta","30",{"name":"twitter:description","content":"Commits on Start a story when the bot is @-mentioned (#15) in vercel-labs/storytime-slackbot."}],["$","meta","31",{"name":"twitter:image","content":"https://trylle.com/api/og.png?kind=repo&owner=vercel-labs&repo=storytime-slackbot"}],["$","meta","32",{"name":"twitter:image:alt","content":"vercel-labs/storytime-slackbot repository preview on Trylle"}],["$","link","33",{"rel":"icon","href":"/favicon.png","type":"image/png"}],["$","link","34",{"rel":"icon","href":"/favicon-white.png","type":"image/png","media":"(prefers-color-scheme: dark)"}],"$L7d","$L7e"]

Commits on Sat, Oct 10, 2026