Skip to content

🤖 refactor: move task waiter state into TaskWaiters - #7668

Merged
ThomasK33 merged 1 commit into
refactor/task-peer-send-parkingfrom
refactor/task-waiters
Oct 27, 2026
Merged

ThomasK33 merged 1 commit into
refactor/task-peer-send-parkingfrom
refactor/task-waiters

Conversation

@ThomasK33

@ThomasK33 ThomasK33 commented Oct 27, 2026 •

Copy link
Copy Markdown
Member

Summary

Moves TaskService's report waiters, start waiters, foreground awaits, user-backgrounded marks, launch-failure marks and the completed-report cache (7 fields) into a new TaskWaiters class (taskWaiters.ts). taskService.ts loses 205 lines in this layer.

Background

PR 2 to 5 of the TaskService split stack (#7665 is PR 1). Each layer moves one group of TaskService state and the methods that own it into a plain class that TaskService builds in its constructor. The rules are the same in every layer: public methods stay on TaskService as one-line facades, methods that tests spy on or patch stay reachable on TaskService and the new class calls them through call-time closures, and tests that cast a moved field change only the cast target. No behaviour changes.

Implementation

  • Moved: the foreground-await and backgrounding methods (all public ones keep facades), armWaitersOfUnendedTask, startPendingStartWaiters, enforceCompletedReportCacheLimit, the waiter and cache types, and ForegroundWaitBackgroundedError. taskService.ts re-exports the error, so its importers do not change.
  • resolveWaiters stays on TaskService (tests call it through casts). It still computes the ancestry, then calls cacheCompletedReport and resolvePendingWaiters, so the cache is still written before any waiter resolves.
  • rejectWaiters stays as the TaskService entry point (a test spies on it), and its body is in the class.
  • waitForAgentReport, readPersistedReportForWait, inspectAttemptOutcome and the termination, reawaken and timeout paths stay. They use accessors in the same order as before.
  • Two small add/remove helpers (appendToListMap, removeFromListMap) replace four near-copies that the DRY gate flagged.
  • Tests: five test files change only a cast target (waiters.<field>). The new taskWaiters.test.ts (13 tests) covers nested foreground awaits, the backgrounding order (mark, persist, reject), start-waiter order and cache eviction.

Validation

  • Tests on this layer and the stack top: all pass.
  • make static-check, make lint-eslint, make crap-check (all moved methods CC 8 or less): pass.
  • make dry-check: the moved ForegroundWaitBackgroundedError constructor matches four existing error constructors. That is existing code reported again because it moved.
  • Mutation on the new class: 47 of 53 killed. The 6 survivors cannot change behaviour (for example ?? 0 → || 0).

Risks

Low to medium: waiters order the report flow. The orders that matter (cache before drain, register before recheck, mark before start) are unchanged and have unit tests now.


Generated with xum • Model: anthropic:claude-opus-5-5 • Thinking: high • Cost: $53.33

Move-only. TaskWaiters (taskWaiters.ts) owns the report waiters, start waiters,
unpersisted launch-failure marks, foreground-await counts, backgroundable
foreground waiters, user-backgrounded marks and the bounded completed-report
cache, plus the methods that only touch them. ForegroundWaitBackgroundedError
moves with it and taskService.ts re-exports it.

TaskService keeps its public and interface methods as one-line facades, keeps
resolveWaiters (ancestry, then cache, then drain) and rejectWaiters (spied on in
tests) as entry points, and reads the cache and waiter lists through accessors.
Deps are call-time closures (scheduleNotifyOnTerminalPersist,
workspaceService.hasQueuedMessages). Test casts now point at `waiters.<field>`.
@ThomasK33
ThomasK33 added this pull request to stack #7670 October 27, 2026 07:59
@ThomasK33
ThomasK33 marked this pull request as ready for review October 27, 2026 08:00
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 27, 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-27T08:02:34.066471Z 370ec00 Manual request
🔒 Security Review ✅ Completed 2026-10-27T08:03:30.695835Z 370ec00 Manual request
ℹ️ 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.

@ThomasK33

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 👍

Reviewed commit: 370ec00710

ℹ️ 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".

@chatgpt-codex-connector

Copy link
Copy Markdown

🛡️ Codex Security Review · Automatically triggered

Security review completed. No security issues were found in this pull request.

Reviewed commit: 370ec00710

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@github-actions

Copy link
Copy Markdown
Contributor

🟢 e2e stories (Haiku): 14 passed

22 agent steps · 7 replayed from cache · 15 model calls · 46.3k tokens (28% cached)
Spend: $0.09 of the $1.00 cap (proxy ledger)

All 14 tests in 9 files
Test Agent Time
🟢 chatRestart.e2e.ts · 1 passed 1 step · 1 call 5.2s
🟢 a chat survives a restart of the server 1 step · 1 call 5.2s
🟢 compaction.e2e.ts · 1 passed 1 step · 1 call 4.3s
🟢 /compact replaces the old chat with a summary 1 step · 1 call 4.3s
🟢 pluginTrustRestart.e2e.ts · 1 passed 4 steps · 2 calls 9.6s
🟢 a trusted plugin hook stays trusted after the server restarts 4 steps · 2 calls 9.6s
🟢 settingsRoundTrip.e2e.ts · 1 passed 2 steps · 1 call 8.8s
🟢 a chat survives trips through Settings 2 steps · 1 call 8.8s
🟢 sidebarPerWorkspace.e2e.ts · 1 passed 4 steps · 1 call 4.3s
🟢 a new workspace starts with its right sidebar collapsed while another keeps it open 4 steps · 1 call 4.3s
🟢 smoke.e2e.ts · 1 passed 2 steps · 1 call 3.0s
🟢 the agent opens the playground workspace 2 steps · 1 call 3.0s
🟢 streamErrors.e2e.ts · 1 passed 1 step · 1 call 10.1s
🟢 stream errors show in the chat, and the chat recovers 1 step · 1 call 10.1s
🟢 todoNudge.e2e.ts · 1 passed 1 step · 1 call 3.9s
🟢 the agent finishes open TODO items after the turn-end nudge 1 step · 1 call 3.9s
🟢 touchAlignment.e2e.ts · 6 passed 6 steps · 6 calls 20.8s
🟢 the Settings close button is level with the title on a touch screen 390px wide 1 step · 1 call 3.9s
🟢 the Settings close button is level with the title on a touch screen 768px wide 1 step · 1 call 3.3s
🟢 Backup settings checkboxes are small and level with their labels on a touch phone 1 step · 1 call 4.0s
🟢 the heartbeat checkbox is small and level with its label on a touch phone 1 step · 1 call 3.4s
🟢 a reply's model and time stay on one line on a touch phone 1 step · 1 call 3.3s
🟢 the workspace actions menu stays on the title row on a touch phone 1 step · 1 call 2.9s

e2e 0.20.0 · 1m 13s · web · run artifacts

🟢 e2e Electron stories (Haiku): 3 passed

3 agent steps · 3 model calls · 8.0k tokens (32% cached)
Spend: $0.01 of the $1.00 cap (proxy ledger)

All 3 tests in 3 files
Test Agent Time
🟢 electron/deepLink.e2e.ts · 1 passed 1 step · 1 call 5.7s
🟢 a deep link of a second launch starts a chat in the running app 1 step · 1 call 5.7s
🟢 electron/menuBar.e2e.ts · 1 passed 1 step · 1 call 7.8s
🟢 the workspace menu bar is the desktop title bar 1 step · 1 call 7.8s
🟢 electron/smoke.e2e.ts · 1 passed 1 step · 1 call 5.0s
🟢 Xum Electron opens the playground workspace 1 step · 1 call 5.0s

e2e 0.20.0 · 20.9s · electron · run artifacts

🟢 e2e agent repros (Haiku): no tests selected

Spend: $0.00 of the $1.00 cap (proxy ledger)

e2e 0.20.0 · 5.3s · 2 targets (web, phone) · run artifacts

@ThomasK33
ThomasK33 added this pull request to the merge queue Oct 27, 2026
Merged via the queue into main with commit b68f04c Oct 27, 2026
48 of 66 checks passed
@ThomasK33
ThomasK33 deleted the refactor/task-waiters branch October 27, 2026 09:37
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