Skip to content

Reference

cdp_nav_graph

Navigation graph tool. PRIMARY: action=“go” — navigates to any screen in ONE call (auto-scans if stale, plans path, executes via NAV_REF, verifies arrival, records outcome, returns heal advice on failure). Other actions for manual control: scan, read, navigate (plan only), record, staleness, playbook, heal.

NameTypeRequiredDefaultConstraintsDescription
actionenum: go | scan | read | navigate | record | staleness | playbook | healYesgo = navigate in one call (recommended). scan/read/navigate/record/staleness/playbook/heal for manual control
navigator_idstringNo(read) Filter to navigator subtree by id
screenstringNo(read/navigate/record/heal) Target screen name
fromstringNo(navigate) Current screen. Omit to use active screen
forcebooleanNofalse(scan) Force re-scan
methodenum: programmatic | deep_link | ui_interactionNo(record/heal) Navigation method
successbooleanNo(record) Whether navigation succeeded
latency_msnumberNo(record) Navigation time in ms
platformenum: ios | androidNo(go/playbook/heal) Platform for playbook tips and heal advice
paramsRecord<string, unknown>No(go) Screen params to pass (e.g. { id: “1” })
cdp_nav_graph(action: <enum: go | scan | read | navigate | record | staleness | playbook | heal>)