Bolt for JavaScript Files

What's Changed

Bring magic to a conversation with sayStream for streaming messages and show loading status with setStatus. Now available for app.event and app.message listeners:

:::ts
app.event('app_mention', async ({ sayStream, setStatus }) => {
  setStatus({
    status: 'Thinking...',
    loading_messages: ['Waking up...', 'Loading a witty response...'],
  });
  const stream = sayStream({ buffer_size: 100 });
  await stream.append({ markdown_text: 'Thinking... :thinking_face:\n\n' });
  await stream.append({ markdown_text: 'Here is my response!' });
  await stream.stop();
});

The respond function now accepts thread_ts to publish responses in a thread:

:::ts
app.action('my_action', async ({ ack, respond }) => {
  await ack();
  await respond({ text: 'Replying in thread!', thread_ts: '1234567890.123456' });
});

Configure ping timeouts, reconnect behavior, and other Socket Mode settings directly through App options:

:::ts
const app = new App({
  socketMode: true,
  appToken: process.env.SLACK_APP_TOKEN,
  token: process.env.SLACK_BOT_TOKEN,
  clientPingTimeout: 15000,
  serverPingTimeout: 60000,
  pingPongLoggingEnabled: true,
});

👾 Enhancements

• feat: add support for sayStream listener argument in [#2841] - Thanks @WilliamBergamin!
• feat: surface the setStatus argument to listeners if required event details are available in [#2843] - Thanks @WilliamBergamin!
• Add thread_ts to RespondFn type in [#2732] - Thanks @misscoded!
• feat(SocketModeReceiver): expose Socket Mode timeout and reconnect options in [#2786] - Thanks @shivasymbl!
• Enable esModuleInterop in tsconfig in [#2719] - Thanks @misscoded!

🐛 Fixes

• fix: Improve ESM compatibility for named exports in [#2724] - Thanks @grantjoy!
• Fixed edge case when there was error during authorize in [#2753] - Thanks @shlomisas!

📚 Documentation

• docs: add "random fact generator" custom step workshop to tutorials in [#2694] - Thanks @haleychaas!
• docs: rework ai tutorial to use openai provider and starter template in [#2731] - Thanks @haleychaas!
• docs: Deploy with Vercel in [#2767] - Thanks @haleychaas!
• docs: Add Vercel note about AI Gateway token needed only locally in [#2781] - Thanks @haleychaas!
• Docs: Add headings so copy as markdown button shows up in [#2796] - Thanks @haleychaas!
• docs: update links to tools reference pages to avoid redirects in [#2722] - Thanks @zimeg!
• docs: updates outmoded links in [#2737] - Thanks @lukegalbraithrussell!
• docs: updates outmoded steps from apps links in [#2738] - Thanks @lukegalbraithrussell!

🧰 Maintenance

• refactor: consolidate event channel and thread extraction in [#2830] - Thanks @WilliamBergamin!
• chore: consolidate context utility creators in [#2828] - Thanks @WilliamBergamin!
• build: use pinned minimum supported node18 version for type checks in [#2801] - Thanks @zimeg!
• build: include the package lockfile for custom receiver example in [#2744] - Thanks @zimeg!
• ci: support node 24 in [#2831] - Thanks @zimeg!
• ci: perform sample and example app tests on regression schedules in [#2743] - Thanks @zimeg!
• ci(deps): auto-approve / auto-merge dependencies from dependabot in [#2780] - Thanks @mwbrooks!
• chore: Add .github/CODEOWNERS file in [#2718] - Thanks @mwbrooks!
• chore: add AGENTS.md in [#2826] - Thanks @WilliamBergamin!
• chore(release): version @slack/bolt@4.7.0 in [#2848] - Thanks @zimeg!

🎁 Dependencies

Core

• chore(deps): update @slack/types requirement from ^2.18.0 to ^2.19.0 in [#2727] - Thanks @dependabot[bot]!
• chore(deps): update @slack/types requirement from ^2.19.0 to ^2.20.0 in [#2790] - Thanks @dependabot[bot]!
• chore(deps): update @slack/types requirement from ^2.20.0 to ^2.20.1 in [#2820] - Thanks @dependabot[bot]!
• chore(deps): update @slack/web-api requirement from ^7.12.0 to ^7.13.0 in [#2730] - Thanks @dependabot[bot]!
• chore(deps): update @slack/web-api requirement from ^7.13.0 to ^7.14.1 in [#2791] - Thanks @dependabot[bot]!
• chore(deps): update @slack/web-api requirement from ^7.14.1 to ^7.15.0 in [#2817] - Thanks @dependabot[bot]!
• chore(deps): update @slack/socket-mode requirement from ^2.0.5 to ^2.0.6 in [#2816] - Thanks @dependabot[bot]!
• chore(deps): update @slack/logger requirement from ^4.0.0 to ^4.0.1 in [#2818] - Thanks @dependabot[bot]!
• chore(deps): update @slack/oauth requirement from ^3.0.4 to ^3.0.5 in [#2819] - Thanks @dependabot[bot]!

👋 New Contributors 🎉

• @grantjoy made their first contribution in https://github.com/slackapi/bolt-js/pull/2724
• @shlomisas made their first contribution in https://github.com/slackapi/bolt-js/pull/2753
• @shivasymbl made their first contribution in https://github.com/slackapi/bolt-js/pull/2786

Full Changelog: https://github.com/slackapi/bolt-js/compare/@slack/bolt@4.6.0...@slack/bolt@4.7.0 Milestone: https://github.com/slackapi/bolt-js/milestone/61 Package: https://www.npmjs.com/package/@slack/bolt/v/4.7.0