mcpserve

type Options struct {
	// BindOnOpen registers session-scoped schema-bound tool variants on a
	// successful pulse_inspect. True gives MCP clients typed enum constraints
	// on field-name parameters; false leaves only the unbound global tools,
	// which is useful for clients that bind tool schemas themselves.
	BindOnOpen bool

	// Version is the server identity advertised during initialize and threaded
	// into the adapter Config. Defaults to pulse.Version() when empty.
	Version string

	// DisableCohortScan skips the startup filesystem walk that enumerates the
	// data root's .pulse files as exact-match pulse:// resources. Cohorts stay
	// readable through the pulse:// template either way — only the
	// resources/list enumeration is withheld. Leave it false (the zero value,
	// the pre-knob behaviour) unless walking the root at startup is itself the
	// cost you are avoiding. A feature profile on the served *pulse.Pulse
	// whose behaviour sets disable_cohort_scan ORs into this field.
	DisableCohortScan bool

	// FeatureProfileFile is a host OS path (absolute, or relative to the
	// process working directory) to a feature profile JSON file. It is
	// consumed by NewPulse, which reads it with the OS filesystem — never
	// the instance's afero Fs or DataDir — parses it with
	// pulse.ParseFeatureProfile and hands the value to pulse.New through
	// pulse.Options.FeatureProfile. Empty falls back to the
	// PULSE_FEATURE_PROFILE environment variable, which NewPulse ignores
	// when the pulse.Options it is given already carry a profile.
	//
	// Serve and ServeStdio ignore it: a profile is applied when the
	// instance is constructed, so serve an instance built by NewPulse
	// (or by pulse.New with a profile) to get one.
	FeatureProfileFile string
}

type ServeInfo struct {
	// CohortScan reports whether the startup walk that enumerates the
	// data root's .pulse files runs. False when Options.DisableCohortScan
	// is set OR the instance's feature profile sets
	// behaviour.disable_cohort_scan — the same OR gosdk.Register applies.
	CohortScan bool

	// FeatureProfileLoaded reports whether the instance was built with a
	// feature profile.
	FeatureProfileLoaded bool

	// FeatureProfile is the loaded profile's free-form "profile" label.
	// Empty when no profile is loaded or the profile carries no label.
	FeatureProfile string
}