mcp

type CredentialResolver interface {
	ResolveMCP(context.Context, string) (Credentials, error)
}

type Credentials struct {
	Env     []EnvVariable
	Headers []HTTPHeader
}

type EnvVariable struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type HTTPHeader struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type MCPConfig struct {
	// Name is a human-readable identifier for the server. It is used as the
	// tool namespace so that tools from this server are grouped together and
	// disambiguated from tools provided by other servers or the harness itself.
	Name string `json:"name"`

	// Type selects the MCP transport: TransportHTTP ("http") or
	// TransportSSE ("sse"). When empty or TransportStdio ("stdio"), the
	// server is launched as a subprocess over stdio.
	Type string `json:"type,omitempty"`

	// Command is the path to the MCP server executable (stdio transport).
	Command string `json:"command,omitempty"`

	// Args are command-line arguments passed to the server (stdio transport).
	Args []string `json:"args,omitempty"`

	// Env are explicit environment variables set when launching the server.
	// Host process variables are inherited only through host-only policy.
	Env []EnvVariable `json:"env,omitempty"`

	// URL is the endpoint URL (http and sse transports).
	URL string `json:"url,omitempty"`

	// Headers are HTTP headers included in requests to the server (http and
	// sse transports). Authorization and other credentials are carried here.
	Headers []HTTPHeader `json:"headers,omitempty"`

	// CredentialRef is a durable opaque reference resolved by the host. Inline
	// Env and Headers remain connection-scoped and are never persisted.
	CredentialRef string `json:"credentialRef,omitempty"`

	// HostEnv is a host-only allowlist of environment variable names inherited
	// by a stdio subprocess. It is never accepted from ACP JSON.
	HostEnv []string `json:"-"`

	// InheritHostEnv is a host-only trusted escape hatch. Client-supplied JSON
	// cannot enable full process environment inheritance.
	InheritHostEnv bool `json:"-"`
}