chore: select only the matching guide when forced guide key is set

[thomaswhyyou]

Description

** Describe what, why and how of the changes clearly and concisely. Add any additional useful context or info, as necessary. **

Todos

** List any todo items necessary before merging, if any. Delete if none. **

• Sample todo item 1
• Sample todo item 2

Checklist

• Tests have been added for new features or major refactors to existing features.

Screenshots or videos

** Attach any screenshots or recordings to visually illustrate the changes, as necessary. Delete if not relevant. **

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
javascript-ms-teams-connect-example	Ready	Preview, Comment	Jan 15, 2026 10:38pm
javascript-nextjs-example	Ready	Preview, Comment	Jan 15, 2026 10:38pm
javascript-slack-connect-example	Ready	Preview, Comment	Jan 15, 2026 10:38pm
javascript-slack-kit-example	Ready	Preview, Comment	Jan 15, 2026 10:38pm

[linear]

KNO-11142 [SDK] Guide Toolbar v2 poc

[changeset-bot]

⚠️ No Changeset found

Latest commit: 4422e2d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[thomaswhyyou]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• chore: select only the matching guide when forced guide key is set #828 👈 (View in Graphite)
• chore: handle ineligible guides in the fetch guides response #827
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 67.57%. Comparing base (0f2e854) to head (4422e2d).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@                              Coverage Diff                              @@
##           thomas-kno-11142-sdk-guide-toolbar-v2-poc     #828      +/-   ##
=============================================================================
- Coverage                                      67.62%   67.57%   -0.05%     
=============================================================================
  Files                                            193      193              
  Lines                                           7993     7972      -21     
  Branches                                        1040     1037       -3     
=============================================================================
- Hits                                            5405     5387      -18     
+ Misses                                          2563     2560       -3     
  Partials                                          25       25              

Files with missing lines	Coverage Δ
packages/client/src/clients/guide/client.ts	88.90% <100.00%> (+0.07%)	⬆️