nativelaunch

type Options struct {
	Role      string
	Harness   string
	ModelTier string
	CWD       string
	TargetDir string
	// RuntimeHome is the session-scoped home a launch consumer staged. When set,
	// projection uses the harness global load points; see docs/projection.md.
	RuntimeHome string
	// OperatingBase leads the composed instructions, so a session home that
	// replaces the host load point keeps the doctrine that file carried.
	OperatingBase string
	// OperatingAppendix travels apart from the base because the base is rewritten
	// before rendering; see cascade.ComposeParts. agent-compose#6987.
	OperatingAppendix string
	// AppendixRoles is every role slug the host appendix scopes a block to, which
	// the resolved roster is the first thing able to check. agent-compose#6945.
	AppendixRoles   []string
	PlanPath        string
	OutDir          string
	PersonSelection compose.Options
	// Identity renames the seat to one of the role's own names, chosen by the
	// caller that knows which instances are live. Empty keeps the primary.
	Identity       string
	SkipProjection bool
	// OmitSkills are ordinary skills left out of the bundle, so a seat's home
	// holds no tool reference for an MCP server its launch omits. COI-2121
	OmitSkills []string
}

type Result struct {
	Composition  *compose.Result
	BundleDir    string
	BundleReused bool
	Projected    int
	ModelTier    string
	Sources      []compose.RootSource
	// SeatName is the resolved display name for the selected seat. The launch
	// path hands it to a harness that can show a session name.
	SeatName string
	// HarnessSettings is the emitted settings fragment for harnesses that read
	// one as a launch argument. Empty when the harness has no such surface.
	HarnessSettings string
}