dsh-pdfcraft

Every configuration field

Each row validates only its own fields; a field placed on the other row is not read by it.

Web Component (pdfcraft-web)

Field	Type	Default	What it does
webBuildDir	string	$DSH_HOME/pdfcraft/web via the bundle patch; the schema default is an empty string	Directory containing the extracted web build's index.html. An empty or wrong value leaves the component mounted and makes the Panel show the missing-build card naming what to fetch. The web build is never downloaded by the plugin.
openTool	boolean	true	Register the person's /pdfcraft command and the agent's pdfcraft_open tool. Set to false to withdraw both and drop any open request that has not reached the browser yet; an already-open Panel is untouched.
maxDocumentBytes	integer	33554432 (32 MiB)	Largest Workspace Document the Panel will open or save, in bytes. A larger read or Write-back is refused with a message naming this limit. This does not limit the agent's tools, which use the upstream engine directly.

CLI Component (pdfcraft-cli)

Field	Type	Default	What it does
cliPath	string	pdfcraft-cli, resolved through PATH	The pdfcraft-cli executable the agent's engine runs. Use an absolute path to pin a specific release. An empty value falls back to pdfcraft-cli.
staticRoot	string	"", meaning each conversation's own workspace	Pin every agent's engine to this absolute directory instead of its conversation's workspace. It must exist; otherwise no engine starts and the warning names the root. This gives up per-conversation isolation; the Panel stays confined to the conversation workspace either way.
compactSurface	boolean	true	Offer the compact agent surface: a small core set of tools plus tool_search and tool_call, which reach every remaining tool. Set to false to expose the full catalogue, at a much higher context cost.

The three fields on each row are that row's whole configuration surface. The bundle patch points the Web row's webBuildDir at the Harness home; if you install the package by some other route, set it explicitly.