Examples

Copy Markdown View Source

These examples show the current public placement seam honestly: callers use CliSubprocessCore APIs and describe placement with execution_surface.

Included Examples

  • examples/command_over_execution_surface.exs shows provider-aware command execution locally and the equivalent SSH placement shape.
  • examples/execution_surface_compatibility.exs shows the compatibility CliSubprocessCore.ExecutionSurface struct flowing through the public command options API without taking transport ownership back from execution_plane.
  • examples/tool_descriptor_validation.exs shows neutral tool descriptor, request, and response validation without spawning a provider CLI or adding host tool execution to core.

Hardening Notes

The emergency hardening work in this repo is primarily profile and contract work, so the strongest example surface is the provider-profile test lane:

  • test/cli_subprocess_core/provider_profiles_test.exs

That suite now proves that the shared transport options preserve chunk-first overflow controls instead of dropping them at the profile boundary.