Surgical Toolbox

Preflight keeps 5 master tools for agent surfaces. Texture workflows are additive actions under existing tools (no new master tool required).

Master Tool Inventory

preflight_session

• load
• export
• reset
• health

preflight_diagnose

• validation
• texture (texture report + diagnosis-to-tool recommendations)
• scene_graph
• model_info
• geometry
• schema

preflight_transform

• scale
• center
• rotate
• visibility
• revert

preflight_fix

• apply
• texture_convert (in-process texture remediation; supports backend=automatic|openSource|appleTextureConverter)
• apply_all
• plan_create
• plan_execute
• undo

preflight_app

• screenshot
• select
• control

CLI Surface

preflighttool exposes the same core engine:

• preflighttool validate <file> (canonical diagnostics stream)
• preflighttool texture analyze <file>
• preflighttool texture convert <input> <output> [options] (--backend automatic|openSource|appleTextureConverter)

App-side texture conversion does not shell out to CLI; conversion is performed in-process through the shared interop layer.

Surface Exposure Matrix

Capability	App Settings	MCP/ACP	CLI
Workflow profile (OpenUSD, RealityKit)	Yes	target_profile input	--profile / --target
Texture diagnose	Diagnostics UI + agent	preflight_diagnose(action=texture)	preflighttool texture analyze
Texture convert backend selection	Yes (default preference)	preflight_fix(action=texture_convert, backend=...)	preflighttool texture convert --backend ...