fix(sidecar): resume truncated Gmail history via page token (#595) - #647
Draft
cursor[bot] wants to merge 2 commits into
Draft
fix(sidecar): resume truncated Gmail history via page token (#595)#647cursor[bot] wants to merge 2 commits into
cursor[bot] wants to merge 2 commits into
Conversation
When listNewMessageIds hits MAX_HISTORY_PAGES the cursor correctly stays frozen, but if pages 1-3 are already deduped the poller re-fetched them forever and never reached page 4+ — silently skipping new mail. Persist history_page_token (migration 32) once a truncated slice is fully worked; the next poll resumes from that nextPageToken with the same cursor. Clear the token on a complete listing or when a batch cap leaves unprocessed ids in the current slice. Co-authored-by: schmug <schmug@users.noreply.github.com>
Co-authored-by: schmug <schmug@users.noreply.github.com>
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
ais-hub | aa76654 | Commit Preview URL Branch Preview URL |
Jul 24 2026, 11:10 AM |
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ✅ Deployment successful! View logs |
agentic-inbox | aa76654 | Jul 24 2026, 11:12 AM |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Bug and impact
When the Workspace sidecar poller hits the
MAX_HISTORY_PAGES=3cap,listNewMessageIdscorrectly setstruncated: trueand the cursor stays frozen. However, if pages 1–3 are already deduped on every poll, the poller re-fetches the same three pages forever and never reaches page 4+. Mail on later history pages is silently skipped — a data-loss bug for high-volume sidecar mailboxes.Root cause
Cursor advancement requires
!hitCap && !history.truncated, but there was no mechanism to resume pagination within the samestartHistoryIdafter a truncated slice was fully worked (all ids deduped or processed).Fix
history_page_tokencolumn (migration 32) to persist the danglingnextPageTokenonce a truncated slice is fully worked.listNewMessageIdsfrom the saved token on the next poll with the same cursor.nextPageTokenfromlistNewMessageIdswhen truncated.Validation
workspace-poll,gmail-client,sidecar-state).