dsh-html-annotate

LIMITATIONS

Known limitations

- PDF, Word, Excel and PowerPoint are out of scope: the built-in preview keeps them. This plugin only claims formats it can turn into an annotatable DOM. - The frame is sandboxed without `allow-same-origin`, so `sessionStorage` / `localStorage` throw inside it. Pages that persist state there degrade to in-memory; pages that read them without a `try/catch` lose that handler. - Only files under the session's workspace root are served. Absolute-path addresses (`absolute/...`) keep going to the built-in preview, which is a static snapshot and does not run page scripts the same way. - The page's own remote references load natively — CDN styles, scripts and images included. That is the point of a real preview, and it also means the preview makes network requests the Harness does not mediate. - Navigation inside the frame stays inside the plugin: following a link to an external site loads that site without the annotation bridge, so annotation stops working there. - The change stream is best effort; when it is unavailable the preview falls back to polling with exponential backoff up to 20 seconds. - No screenshots are taken. What the model sees is structure, text and computed styles.