Skip to content

feat(titles): add opt-in automatic agent titles - #1216

Open
Juliusolsson05 wants to merge 6 commits into
mainfrom
feat/auto-agent-titles
Open

Juliusolsson05 wants to merge 6 commits into
mainfrom
feat/auto-agent-titles

Conversation

@Juliusolsson05

Copy link
Copy Markdown
Owner

Fixes #1210.

What changed

  • Adds an opt-in Auto Title MCP domain for all five agent providers. title_set({title}) targets only the authenticated pane and stores a short current-job label in the existing workspace title field.
  • Preserves manual titles and manual clears until Resume Auto Title is chosen. Automatic provenance survives reload/undo, and an unrelated conversation starts without the previous agent's automatic title.
  • Reuses the bounded Claude/Codex turn-hook path to remind an untitled agent. A stalled renderer title read fails open within 750 ms so TLDR, Goal, and Goal Loop hooks still complete.
  • Adds managed skill guidance where provider skill discovery is supported, Settings and per-agent controls, UI copy, and README guidance. Grok gets the tool and its description; native Grok skill and hook delivery remain unverified.

Plan: docs/superpowers/plans/2026-09-24-auto-agent-titles.md. Decomposition and provider evidence: docs/decomposition/auto-agent-titles.md.

Verification

  • npm run typecheck passed on current origin/main after rebase.
  • npm run test:package passed, including build-output verification.
  • 137 focused tests across 13 files passed, including real MCP bearer, two-window Electron control, managed skill, hook, recovery, and renderer UI paths.
  • Fail-first tests captured missing tool/control/hook behavior. Review regression tests for hook deadline, exact window routing, unrelated conversation, and Resume UI were mutation-checked by disabling the corresponding fix and observing failure.
  • Local npm run check reached the full suite: 6,633 passed and two failed under Node 25.5.0. The command-history localStorage failure reproduces on clean main and is tracked in test: renderer localStorage setup fails on Node 25 #1212. The legacy settings hydration test timed out only in this branch's full parallel run; it passes in isolation on both branches and in clean main's full run. Clean main's full run had a separate extension-frame failure. CI uses Node 24 and will provide the merge gate.

Review disposition

Finding Verdict Disposition
Optional title read can outwait a provider hook Valid Fixed in 351a0c53; title read is bounded and fail-open.
An unrelated loading window blocks title control Valid Fixed in 351a0c53; route through the session's leased window.
Unrelated conversation inherits the old automatic title Valid Fixed in 351a0c53; reset auto title on new conversation.
Grok does not receive a native managed skill Valid Documentation corrected; native delivery tracked in #1215.
Inherited subagent bearer can title the parent Valid, transport work Main-agent-only guidance added; hard exclusion tracked in #1213.
An admitted write can finish after bearer revocation Valid, lifecycle work New requests are denied; atomic write/retirement ordering tracked in #1214.
Resume UI surface lacked an integration test Valid Added real surface test and mutation checked it.

Merge only after CI and explicit approval.

Record the measured provider-title differences and the workspace ownership boundary before implementation. The staged contract protects manual titles and keeps one durable title writer.\n\nRefs #1210
Let a scoped MCP agent maintain a short current-job label through the renderer-owned title reducer. Preserve manual titles and clears, carry provenance across recovery, and share bounded missing-title hooks on Claude and Codex. Add managed skill guidance and settings for all five providers.
Bound optional title state reads within provider hook deadlines, route title capabilities through the leased window, and drop automatic titles when replacing a pane with an unrelated conversation. Cover the actual resume surface and instruct inherited subagents not to rename their parent pane.
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.

feat(titles): let agents maintain short automatic titles

1 participant