Requirements
The plugin is installed into a DSH profile and the README reports testing with DSH 0.1.0-rc.6. It uses OpenPencil’s headless exporter and Web SDK to process .op documents. The documented workflow runs in the DSH web app. Documents are addressed by workspace-relative paths and saved through DSH’s sandboxed filesystem.
Commands and tools
The agent-facing tools are:
| Tool |
Behaviour |
openpencil_new |
Creates a new .op from one batch_design program. It requires a new path and does not overwrite an existing path. |
openpencil_create |
Applies a transactional batch_design program to an existing live canvas. |
openpencil_edit |
Changes an explicit node, or the single node selected by the user. |
openpencil_render |
Creates an immutable, content-addressed .op snapshot and renders every top-level frame on the active page. |
openpencil_selection |
Reads the nodes selected in the live editor canvas. |
openpencil_render accepts the documented options scale, editable and autoOpen. editable: true opens the managed editor; autoOpen: true is used in the documented workflow to present the returned document.
How it behaves
A batch_design program runs in a private managed OpenPencil daemon. For a new document, publication occurs only after the whole batch succeeds, so a failed batch does not leave an empty file. Rendering produces a large preview for the first top-level frame and a thumbnail rail for additional frames. The interactive canvas is read-only; the managed editor supplies editing and explicit save operations.
Preview and editor access use signed, hash-bound capabilities. Arbitrary host paths are not exposed through browser metadata, and these capabilities are not included in canonical tool results or model context. Existing saves use an optimistic hash and atomic replace.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub