Environment Inspect
- Call
env_inspectwhen machine/runtime state can change the next action. - Read the returned snapshot as evidence. Availability values are tri-state:
true— observed present/enabled;false— observed absent/disabled;null— the probe did not establish the fact.
- Treat top-level
status: degraded,snapshot.success: false, or a relevant entry insnapshot.errorsas partial evidence. Do not convert an unknown/failed probe into “missing.” - The broad snapshot establishes Windows feature state and executable presence without launching developer binaries for version output. Use
tool_discoveronly when a focused executable/version check can change the route.tool_discoverexecutes discovered programs with a version argument, so it remains on the active host permission surface even though the requested effect is diagnostic. If the executable is present but its version probe fails, preserveversion_status: unknownrather than inventing a version. - Treat cached environment state as time-bound. After an install, optional-feature change, PATH/toolchain mutation, or other action that can invalidate the field you are about to consume, prefer the narrow fresh probe; if a full snapshot is required, call
env_inspectwithforce_refresh: true. - Use
ecosystem_scanfor MCP configs, extensions, project agent config, or host plugin inventory. Project-only inventory is the narrow default; requestinclude_host: trueonly when user-level state is actually needed. - Suggest a repair only when observed state blocks or materially degrades the requested task.
For package installation, route to the package-install skill and package_search / package_install MCP tools rather than emitting an unreviewed install command.