mcptest

type BigInput struct {
	Bytes int `json:"bytes" jsonschema:"how many bytes of text to return"`
}

type Config struct {
	// Instructions is the server's instructions string, returned at
	// initialize. Empty means the server sends none.
	Instructions string

	// Prompts adds the "greet" prompt (which takes arguments), and with it the
	// prompts capability.
	Prompts bool

	// Resources adds the static resource and the echo resource template, and
	// with them the resources capability.
	Resources bool

	// Mutate adds the "mutate" tool, which adds or removes ToolMutated at
	// runtime and so makes the server emit notifications/tools/list_changed.
	Mutate bool

	// Crash adds the "crash" tool, which exits the process immediately with
	// CrashExitCode: no reply, no shutdown, no flush.
	Crash bool

	// CrashExitCode is the status the "crash" tool exits with. It must be in
	// [1, 125] — a crash that exits 0 is not a crash, and the shell reserves
	// the values above 125.
	CrashExitCode int

	// NoiseBytes is how much the fixture writes to stderr at startup. It is
	// written by the command, not by NewServer; see WriteNoise.
	NoiseBytes int

	// ElicitOnInitialize makes the server send an elicitation request as soon
	// as the client's "initialized" notification arrives. See NewServer for
	// what "as soon as" can and cannot mean here.
	ElicitOnInitialize bool

	// Elicit adds the "elicit" tool, which asks the client a question while
	// answering a tool call and reports what it was told.
	//
	// It is a tool rather than another unprompted send because that is what
	// makes an elicitation *observable to the caller*: the client drives it,
	// and the answer the human gave comes back in the tool's own result. A
	// test asserts on a reply instead of waiting for a notification that may
	// or may not have happened yet. ElicitOnInitialize keeps its own,
	// different job: the first moment a server is allowed to speak unprompted.
	Elicit bool

	// PageSize caps how many items the server returns per list page. Zero uses
	// the SDK's default (1000), which no fixture catalog comes close to — so a
	// test that needs to exercise a client's pagination sets this to 1 or 2 and
	// gets a genuinely multi-page server rather than a simulated one.
	PageSize int

	// ExtraTools adds this many trivial echo-shaped tools, named
	// ExtraToolPrefix + index. It exists so a test can build a catalog big
	// enough to paginate, or big enough to exceed a client's item bound.
	ExtraTools int

	// Stateless serves the Streamable HTTP handler in stateless mode
	// (SEP-2567), which is what lets a client negotiate spec revision
	// 2026-07-28: no Mcp-Session-Id, no server-initiated requests, GET and
	// DELETE answered 405. Meaningless for the stdio and SSE fixtures, whose
	// constructors refuse it.
	Stateless bool

	// LegacyProtocol pins the stdio fixture (cmd/fixture) to protocol
	// revisions at or before mcptest.LegacyProtocolVersion, via
	// PinLegacyProtocol. It exists for tests that need a real server to make
	// an ad hoc ServerSession.Elicit / ListRoots / CreateMessage call: SDK
	// v1.7.0 forbids all three once the negotiated version reaches
	// 2026-07-28 (SEP-2322), and offers no other way to request an older
	// version from a test peer. Meaningless over HTTP, where
	// StreamableServerTransport already implements
	// mcp.ProtocolVersionSupporter on its own; only cmd/fixture consults it.
	LegacyProtocol bool
}

type EchoInput struct {
	Text string `json:"text" jsonschema:"the text to echo back verbatim"`
}

type ElicitInput struct {
	// Mode is the elicitation mode to send, verbatim. It is a free string, not
	// an enum, precisely so a test can send a mode MCP does not define and see
	// what a client does with it — which is the interesting case.
	Mode string `json:"mode,omitempty" jsonschema:"the elicitation mode to send (form, url, or anything else)"`
	// Message overrides the prompt. Empty uses ElicitMessage.
	Message string `json:"message,omitempty" jsonschema:"the prompt to send; defaults to the fixture's own"`
	// Schema, when true, requests a one-string-field form, so a test can
	// exercise a client that has to carry a schema to a human and an answer
	// back through it.
	Schema bool `json:"schema,omitempty" jsonschema:"request a {name: string} form schema"`
	// URL is the action URL to send, for url mode.
	URL string `json:"url,omitempty" jsonschema:"the action URL, for url mode"`
}

type FailInput struct {
	Message string `json:"message,omitempty" jsonschema:"the message to report in the error result"`
}

type LogInput struct {
	Bytes int    `json:"bytes" jsonschema:"how many bytes of log message to emit"`
	Level string `json:"level,omitempty" jsonschema:"the level to log at; defaults to info"`
}

type MutateInput struct {
	Add bool `json:"add" jsonschema:"true to add the echo2 tool, false to remove it"`
	// Schema re-adds echo2 under a DIFFERENT input schema.
	//
	// It exists because "the tool kept its name and changed its contract" is
	// otherwise unreachable: add/remove can only make a tool appear or vanish,
	// and a client's schema-drift handling is invisible against a server that
	// never drifts. With it, one call turns generation N's echo2(text) into
	// generation N+1's echo2(word) — same name, same server, incompatible
	// interface.
	Schema bool `json:"schema,omitempty" jsonschema:"with add, register echo2 under a different input schema"`
}

type MutatedAltInput struct {
	Word string `json:"word" jsonschema:"the word to echo back verbatim"`
}

type ProgressInput struct {
	Count int  `json:"count" jsonschema:"how many progress notifications to send"`
	MS    int  `json:"ms,omitempty" jsonschema:"how long to pause between notifications, in milliseconds"`
	Hang  bool `json:"hang,omitempty" jsonschema:"true to keep reporting progress forever and never reply"`
}

type SlowInput struct {
	MS int `json:"ms" jsonschema:"how long to sleep before replying, in milliseconds"`
}

type TB interface {
	Helper()
	TempDir() string
	Fatalf(format string, args ...any)
}