docs: combined concurrency limits and queue gates

[matt-aitken]

Summary

Documents the queue concurrency features shipping in this stack: the combinedConcurrencyLimit queue option that caps a keyed queue across all of its concurrencyKey values, queue gates (array queue syntax for holding a slot in more than one queue), and the combined override/reset SDK methods and endpoints.

The concurrency guide gains sections on combined limits and gates with self-hosting notes for the server flags, the OpenAPI spec gains the two combined endpoints and the concurrency.combined response field, and the management reference gains pages for both new endpoints.

Stacked on #4830.

[changeset-bot]

⚠️ No Changeset found

Latest commit: bf2e961

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

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Team

Run ID: 524dbd1f-5cfa-4c64-8de1-a26e10cfb732

📥 Commits

Reviewing files that changed from the base of the PR and between eb33462 and e07558e.

📒 Files selected for processing (1)

• docs/queue-concurrency.mdx

🚧 Files skipped from review as they are similar to previous changes (1)

• docs/queue-concurrency.mdx

Included review availability: Your plan provides up to 10 included reviews per hour; 3 remain after this review.

📜 Recent review details

⏰ Context from checks skipped due to timeout. (3)

• GitHub Check: code-quality / code-quality
• GitHub Check: Analyze (javascript-typescript)
• GitHub Check: Build and publish previews

---

Walkthrough

The OpenAPI specification adds combined concurrency override and reset endpoints. It documents combined concurrency state on QueueObject and requires a request body for the existing reset endpoint. The queue concurrency guide adds combined-limit patterns, gate queue examples, tenant and shared-resource limits, and SDK override and reset methods. Documentation navigation adds separate pages for the new endpoints.

Merge Risk: ⚪ Minimal · up to bf2e9

This change documents combined queue concurrency APIs, configuration, and usage patterns. No current merge-blocking risk is identified.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description accurately summarizes the documentation changes, but it does not follow the repository template. It omits the required checklist, testing details, changelog, screenshots section, and i…	Add the required template sections. Include the relevant issue reference, complete the checklist, describe testing performed, add a short changelog entry, and include the screenshots section or state that screenshots are not applicable.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the main documentation changes for combined concurrency limits and queue gates. It is concise and specific.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Description check

Explanation

The description accurately summarizes the documentation changes, but it does not follow the repository template. It omits the required checklist, testing details, changelog, screenshots section, and issue-closing line.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/queue-concurrency-features

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[pkg-pr-new]

Open in StackBlitz

@trigger.dev/build

npm i https://pkg.pr.new/@trigger.dev/build@bf2e961

trigger.dev

npm i https://pkg.pr.new/trigger.dev@bf2e961

@trigger.dev/core

npm i https://pkg.pr.new/@trigger.dev/core@bf2e961

@trigger.dev/python

npm i https://pkg.pr.new/@trigger.dev/python@bf2e961

@trigger.dev/react-hooks

npm i https://pkg.pr.new/@trigger.dev/react-hooks@bf2e961

@trigger.dev/redis-worker

npm i https://pkg.pr.new/@trigger.dev/redis-worker@bf2e961

@trigger.dev/rsc

npm i https://pkg.pr.new/@trigger.dev/rsc@bf2e961

@trigger.dev/schema-to-json

npm i https://pkg.pr.new/@trigger.dev/schema-to-json@bf2e961

@trigger.dev/sdk

npm i https://pkg.pr.new/@trigger.dev/sdk@bf2e961

commit: bf2e961