mcptest

type HTTPUpstream struct {
	URL   string
	Close func() // stops the server, which then refuses connections
	// contains filtered or unexported fields
}

type OAuthUpstream struct {
	Base string // the server's origin, which is also the issuer
	URL  string // the MCP endpoint
	// contains filtered or unexported fields
}

type Rendezvous struct {
	N   int
	Dir string
}

type Startup string

type Stdio struct {
	// Protocol, if set, is the one protocol version it supports, which sets
	// its era.
	Protocol string  `json:",omitempty"`
	Startup  Startup `json:",omitempty"`

	// PIDFile gets its PID.
	PIDFile string `json:",omitempty"`
	// EnvFile gets its environment, one VAR=value per line.
	EnvFile string `json:",omitempty"`
	// Stderr is written to its stderr at startup.
	Stderr string `json:",omitempty"`

	// Rendezvous makes it mark its arrival in Rendezvous.Dir and not answer
	// until Rendezvous.N fakes have arrived there.
	Rendezvous *Rendezvous `json:",omitempty"`

	// IgnoreSIGTERM makes it ignore SIGTERM and its stdin closing, so only
	// SIGKILL stops it.
	IgnoreSIGTERM bool `json:",omitempty"`
	// GrandchildPIDFile makes it start a child that shares its stderr and
	// sleeps until killed, and gets that child's PID.
	GrandchildPIDFile string `json:",omitempty"`
	// LeaveGroupPIDFile makes it leave its process group for that of a
	// child that sleeps until killed, and gets the child's PID, which is
	// also the new group's. Signals to its old group no longer reach it,
	// and it ignores its stdin closing, so it never exits on its own.
	LeaveGroupPIDFile string `json:",omitempty"`
	// HangUpAfterList makes it exit 1 as soon as it has written its answer
	// to tools/list.
	HangUpAfterList bool `json:",omitempty"`

	// ExtraTools are names of further tools, each taking no arguments and
	// answering with ID, so a test can tell which Upstream answered.
	ExtraTools []string `json:",omitempty"`
	ID         string   `json:",omitempty"`
	// BadSchemaTool is the name of one more tool, whose input schema is not
	// an object schema.
	BadSchemaTool string `json:",omitempty"`
	// CrashTool adds a tool "crash" that makes it exit 1 mid-call, without
	// answering. It hangs up its stdout first and exits only once the
	// Gateway reacts with SIGTERM, so the Gateway always sees the exit after
	// closing the connection itself.
	CrashTool bool `json:",omitempty"`
	// OrphanToolPIDFile adds a tool "orphan" that starts a child sharing
	// its stdout and stderr, then exits 1 mid-call, without answering. The
	// child sleeps until killed, holding the Upstream's stdout and stderr
	// open; the file gets its PID.
	OrphanToolPIDFile string `json:",omitempty"`
	// BlockToolFile adds a tool "block" that writes "started" to the file,
	// blocks until the call is cancelled, then writes "cancelled" to it.
	BlockToolFile string `json:",omitempty"`
	// GatherTool, if positive, adds a tool "gather" that answers only once
	// GatherTool calls to it are in flight together.
	GatherTool int `json:",omitempty"`
	// AskTool adds a tool "ask" that asks for interactive input mid-call
	// (multi-round-trip), and answers once it has some.
	AskTool bool `json:",omitempty"`
}