CodeNomad/dev-docs
Pascal André e68ac52413
fix(automation): remove the active-conversation targeting requirement (#746)
## Summary

Remove the requirement that the invoking agent's conversation must
already be active before CodeNomad UI automation can inspect or navigate
the application. That restriction prevented agents from using the UI to
return to their own conversation after a session or project switch.

- Target the inspected native window/run independently of the selected
conversation or project, including views with no active session.
- Keep the actual selected context in inspection results as descriptive
metadata.
- Pin actions to the inspected native window/run. Keep accessibility
references document-scoped: page replacement, reload and native target
changes still require fresh inspection, while conversation selection
alone does not.
- Keep authenticated backend discovery and browser-preview session
attachments intact.
- Document the behavior and add CDP/route regressions for navigation,
empty views and native target changes.

## Validation

- 27 targeted CDP, automation route and plugin tests passed.
- `npx tsc -p packages/server/tsconfig.json` and `git diff --check`
passed.
- Compiled shared server modules installed in the usual Windows Tauri
installation.
- The actual native automation bridge navigated **CodeNomad → opencode →
gaffer → openchamber → CodeNomad** from the same invoking session,
successfully inspecting each different active conversation and returning
to the original conversation.
- Native restart/reconnection, final inspection and screenshot
succeeded.

The implementation is shared by Electron and Tauri; no host-specific
code changes are needed. Installed desktop validation was performed on
Windows Tauri.

Maintenance note: the touched `packages/server/src/developer-cdp.ts` is
approximately 564 lines; this PR does not refactor it solely for length.
2026-09-22 10:15:37 +02:00
..
ui-harmonization-demo V2(ui): progressively harmonize the CodeNomad interface (#667) 2026-09-15 14:17:30 +01:00
architecture.md feat(browser): add autonomous native previews (#666) 2026-09-18 17:46:14 +02:00
BROWSER_AUTOMATION.md fix(automation): remove the active-conversation targeting requirement (#746) 2026-09-22 10:15:37 +02:00
CACHE_REFRESH_CONVENTIONS.md fix(startup): unblock restoration during worktree Git discovery (#745) 2026-09-22 10:13:34 +02:00
DEV_V2_CODE_REDUCTION.md feat(opencode): migrate CodeNomad to native V2 (#647) 2026-09-04 11:36:11 +01:00
DEVELOPER_MODE.md feat(browser): add autonomous native previews (#666) 2026-09-18 17:46:14 +02:00
INDEX.md docs(opencode): define stable runtime setup and update plan 2026-09-20 14:31:45 +02:00
MVP-PRINCIPLES.md feat(opencode): migrate CodeNomad to native V2 (#647) 2026-09-04 11:36:11 +01:00
OPENCODE_V2_COMPATIBILITY.md feat(chat): add native /btw side questions 2026-09-21 17:23:11 +02:00
OPENCODE_V2_POST_BETA.md merge(dev): qualify history integration before PR 696 merge 2026-09-21 00:30:53 +02:00
PALETTE_REVIEW_2026-09-08.md V2(ui): progressively harmonize the CodeNomad interface (#667) 2026-09-15 14:17:30 +01:00
PALETTE_SOURCES.md V2(ui): progressively harmonize the CodeNomad interface (#667) 2026-09-15 14:17:30 +01:00
SAVED_PALETTE_CALIBRATION_2026-09-11.md V2(ui): progressively harmonize the CodeNomad interface (#667) 2026-09-15 14:17:30 +01:00
SESSION_ENVIRONMENT.md fix(environment): refresh profile variables before each prompt (#714) 2026-09-19 18:18:56 +02:00
SESSION_HISTORY_NAVIGATION.md fix(ui): preserve semantic icons for historical timeline tools (#738) 2026-09-21 23:46:51 +02:00
SESSION_HISTORY_QUERIES.md feat(history): add global timeline and direct message-window navigation 2026-09-20 12:04:30 +02:00
SESSION_HISTORY_STRESS_REVIEW.md feat(history): persist timeline indexes and reconcile changed checkpoints 2026-09-20 23:21:03 +02:00
SESSION_PRUNING_DEPLOYMENT.md feat(pruning): restore opt-in selective deletion through native plugin RPC (#686) 2026-09-10 13:31:40 +02:00
SESSION_PRUNING_RPC.md feat(history): query full sessions and clean technical content through native RPC 2026-09-20 11:02:31 +02:00
SESSION_PRUNING_SAFETY.md feat(pruning): restore opt-in selective deletion through native plugin RPC (#686) 2026-09-10 13:31:40 +02:00
solidjs-llms.txt update blank session cleanup code for now session store logic 2025-11-27 20:18:22 -05:00
SUMMARY.md feat(v2): manage session families across worktrees (#649) 2026-09-17 22:57:37 +02:00
TAB_CHROME_REVIEW_2026-09-10.md V2(ui): progressively harmonize the CodeNomad interface (#667) 2026-09-15 14:17:30 +01:00
technical-implementation.md fix(opencode): support earlier and modern V2 runtime contracts (#695) 2026-09-16 23:48:08 +02:00
TOOL_CALL_IMPLEMENTATION.md Split workspace into electron and ui packages 2025-11-17 12:06:58 +00:00
user-interface.md Puff-up README 2025-11-14 23:26:13 +00:00
WORKTREE_SESSION_PLACEMENT.md fix(worktrees): unblock existing-worktree selection on large repositories (#740) 2026-09-21 17:33:11 +02:00