mcp

type Client struct {
	// contains filtered or unexported fields
}

type DriftError struct {
	Server, Tool, Pinned, Got string
}

type Listed struct {
	Name         string               `json:"name"`
	Title        string               `json:"title,omitempty"`
	Description  string               `json:"description"`
	Annotations  *sdk.ToolAnnotations `json:"annotations,omitempty"`
	InputSchema  json.RawMessage      `json:"input_schema"`
	OutputSchema json.RawMessage      `json:"output_schema,omitempty"`
	Digest       string               `json:"digest"`
}

type Server struct {
	// Name is the operator's name for the server, used in errors.
	Name string
	// Argv is the program and its arguments, for a server run over stdio.
	Argv []string
	// URL is a remote server's endpoint, spoken to over streamable HTTP,
	// in place of Argv. It must pass CheckURL.
	URL string
	// Token gives the bearer token sent to a remote server, or is nil to
	// send none. renew is set after the server refused the token it gave
	// (a 401), so it may get a new one.
	Token func(ctx context.Context, renew bool) (string, error)
	// HTTPTransport carries a remote server's requests. Nil means one
	// like Go's default, with no proxy.
	HTTPTransport http.RoundTripper
	// Env is the whole environment, as K=V, of a stdio server. Nil means
	// empty: nothing is inherited.
	Env []string
	// Dir is the working directory. Empty means the current one.
	Dir string
	// Stderr receives what the server writes to stderr, for the
	// operator. Nil discards it.
	Stderr io.Writer
	// SendLabels sends the session's labels in each call's _meta. Off,
	// the server does not learn them. The call id is always sent.
	SendLabels bool
	// Restart starts a server that has died, or whose connection was
	// lost, again for the next call, which must find every definition as
	// pinned. Off, only Reconnect starts it again. A server that broke the
	// protocol, or whose restart found a changed definition, is never
	// restarted on its own.
	Restart bool
	// StartTimeout bounds a restart. Zero means DefaultStartTimeout.
	StartTimeout time.Duration
	// Tools is the allowlist: each tool the agent may call, by the name
	// the server gives it.
	Tools map[string]ToolConfig
	// MaxMessageBytes caps one JSON-RPC message from the server. Zero
	// means DefaultMaxMessageBytes.
	MaxMessageBytes int
}

type ToolConfig struct {
	// Alias is the name the agent, the model and the policy know the tool
	// by. Empty means the server's name for it.
	Alias string
	// Labels are carried by every result of the tool.
	Labels []string
	// Digest pins the tool's definition. Empty accepts whatever the
	// server lists, and Client.Digests says what that was.
	Digest string
	// AllowContent lists the non-text content kinds a result may carry
	// (Image, Audio, ResourceLink, Resource). The model sees a
	// placeholder for each, never the content, except that an embedded
	// resource holding text (not a blob) is shown as that text.
	AllowContent []string
	// FixedArgs are arguments set for every call, by name, as JSON. The
	// model is not shown them and a call that gives one is refused.
	FixedArgs map[string]json.RawMessage
	// HiddenArgs are arguments the model is not shown, and a call that
	// gives one is refused. A required argument cannot be hidden.
	HiddenArgs []string
}