Skip to content

🔀 docs: Document Pull Request Providers, Hosts and Per-User Accounts - #821

Open
berry-13 wants to merge 1 commit into
mainfrom
berry-13/docs-pull-requests
Open

berry-13 wants to merge 1 commit into
mainfrom
berry-13/docs-pull-requests

Conversation

@berry-13

Copy link
Copy Markdown
Collaborator

Summary

Brings the conversation pull request docs from #808 up to date with the finished feature in LibreChat-AI/LibreChat#16982 and #16985 to #16990. The pages now cover GitLab merge requests (with nested group paths), Bitbucket Cloud, GitHub Enterprise Server and *.ghe.com hosts, the token fallback variables for each provider, and why provider, host and oauth are read from librechat.yaml only. They also cover per-user accounts through oauth, with app registration steps for GitHub, GitLab and Bitbucket, the Redis sharedCache for replicas, a tuning reference, and new troubleshooting rows.

#16876 has merged, so its "Pending" and "Older versions" notes are gone. Bitbucket, sharedCache and oauth (#16987 to #16990) are still open upstream and are marked Pending in the same style. A hidden comment says to remove those markers once the PRs merge.

Change Type

  • Documentation update

Testing

  • All 8 pullRequests YAML examples parse with agentsEndpointSchema and configSchema from the LibreChat stack head.
  • pnpm lint:prettier, pnpm typecheck and pnpm lint pass.
  • pnpm build passes.

Checklist

  • Defaults, ranges and behavior checked against the LibreChat source, not memory
  • Only English pages edited; translations come from CI
  • No new pages or nav entries; the existing feature page, config reference, .env reference and Code Interpreter cross-link were updated

Extend the conversation pull request docs to the final feature: GitLab and Bitbucket Cloud providers, Enterprise and self-managed hosts, per-provider token fallbacks, YAML-only provider, host and oauth keys, per-user OAuth accounts, and the Redis shared cache. Drop the pending notes for the now merged default-on change.
@vercel

vercel Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
librechat-ai Ready Ready Preview Oct 11, 2026 9:58pm UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-11T21:56:11.425584Z bfa5a10 PR opened
🔒 Security Review ✅ Completed 2026-10-11T21:54:13.065739Z bfa5a10 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bfa5a1021a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

title: Conversation Pull Requests
icon: GitPullRequest
description: Show the GitHub pull request, size and CI status for chats that run code in an attached workspace.
description: Show the pull request or merge request, size and CI status for chats that run code in an attached workspace, on GitHub, GitLab or Bitbucket Cloud.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove unreleased Bitbucket support from the page summary

The frontmatter description is rendered independently in search results and documentation cards, where it advertises Bitbucket Cloud as currently supported even though this commit explicitly records Bitbucket support as pending on upstream PR #16987. The later (**Pending**) qualifier in the page body will not accompany that summary, so omit Bitbucket here or qualify it until the implementation ships.

Useful? React with 👍 / 👎.

3. The worker reports its branch. This needs a worker built from `LibreChat-AI/code-interpreter` PR #311 or later, and `CODEAPI_BRIDGE_LANE_GIT=true` set on the Code API. See [Code Interpreter](/docs/features/code_interpreter#attached-environments-and-pairing).

If a requirement is missing, chats simply show no pull request and no error is shown to the user. The exception is a `token` that is set but whose environment variable is empty or missing: lookups then fail with `NOT_CONFIGURED`, and sidebar rows show the warning icon with a retry button.
The feature is on by default. Without a token or a repository scope it stays dormant, and every chat simply shows no pull request, with no error. `enabled: false` turns it off whatever else is set.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Exempt OAuth-only deployments from the dormant rule

When oauth is configured without a server token or repository scope, this sentence says the feature stays dormant, contradicting the newly documented behavior that a working OAuth app enables the feature by itself. Once the pending per-user-account support ships, this can lead administrators to add an unnecessary shared token; qualify the rule with the absence of a working OAuth app.

Useful? React with 👍 / 👎.

| ------------------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| No chip and no sidebar mark anywhere | No token, no repository scope, or `enabled: false` | Check [Setup](#setup). Open `/api/config` while signed in and look for `pullRequestsEnabled: true`. |
| Header chip works, sidebar rows show nothing | `pullRequestsBatchVersion` is missing from `/api/config` (old build, or a stale tab) | Rebuild or upgrade the server, restart, and hard reload. Confirm `pullRequestsBatchVersion: 1`. |
| No chip for a chat in an attached workspace | The repository is not in `allowedRepositories` | Add it, or its owner as `owner/*`. A repository out of scope looks the same as one without a pull request. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Qualify the repository-scope troubleshooting advice

For a user with a connected OAuth account, allowedRepositories is deliberately ignored, so adding the repository or its owner as this row recommends cannot restore the missing chip. It may instead broaden the separate server token's access. Qualify this cause and fix as applying only to server-token lookups, and direct connected users to verify their account or app access.

Useful? React with 👍 / 👎.

@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

This branch was successfully deployed

1 active deployment
Preview — bfa5a102 Deployed Oct 11, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant