Files
jackwener__opencli/sitemaps/gmail/workflows/read-thread.md
T
jakevin 6b3dffd398 feat(gmail): add browser-backed Gmail adapter (#2396)
* feat(gmail): add browser-backed adapter

* docs(gmail): document adapter commands

* refactor(gmail): remove unsupported write surface

* chore(gmail): split author workflow into dedicated PR

---------

Co-authored-by: OpenCLI-sol <opencli-sol@users.noreply.github.com>
2026-08-25 21:37:08 +08:00

1.1 KiB

schema_version, workflow_id, intent, last_verified, source
schema_version workflow_id intent last_verified source
1.1 read-thread read a Gmail conversation and its attachment metadata 2026-08-25 global

Goal

Resolve a search thread id into complete message bodies and optional attachment metadata.

State signature

  • entry: thread id from Gmail search, legacy hex id, or Gmail thread URL
  • success: thread page has scoped message containers and command returns message rows

Best path

adapter: opencli gmail thread <thread>; use opencli gmail attachments <thread> for attachment rows adapter_health: healthy preconditions: signed in; target id valid estimated_turns: 1

Fallback path

on_adapter_fail:

  1. adapter_health_update: opencli gmail thread -> suspect
  2. Search again so the target [data-legacy-thread-id] row is mounted.
  3. Open that row; expand collapsed messages.
  4. Extract .a3s and .aQH only inside each [data-message-id] container.

Avoid

  • Page-level first-match body/attachment selectors.
  • Retrying an fd capture indefinitely when Gmail served cached rendered content.
  • Logging or saving real message bodies as fixtures.