probe

type Check struct {
	Name   string `json:"name"`
	Status Status `json:"status"`
	Detail string `json:"detail,omitempty"`
}

type Engine struct {
	HTTP *http.Client
	// UserAgent is sent on every request.
	UserAgent string
	// GitHubToken, when set, is sent only to api.github.com to raise the rate
	// limit. It is never sent to a probed server.
	GitHubToken string
	// Now supplies the clock; overridable in tests.
	Now func() time.Time
	// RemoteTimeout bounds each remote-endpoint request.
	RemoteTimeout time.Duration
	// RequestTimeout bounds each registry/repo/package request.
	RequestTimeout time.Duration
	// ProbeTools runs the go-sdk tools/list conformance probe on reachable,
	// conformant remotes. Default true; a bulk scan can disable it for speed.
	ProbeTools bool
	// ProbeReadiness runs the 2026-07-28 spec-readiness pass against the
	// first conformant remote. Default true.
	ProbeReadiness bool
	// ValidateServerJSON validates a registry server's server.json against its
	// declared JSON Schema. Default true.
	ValidateServerJSON bool
	// contains filtered or unexported fields
}

type PackageSignal struct {
	Type       string `json:"type"` // npm|pypi|oci
	ID         string `json:"id"`
	Status     string `json:"status"` // published|missing|unpublished|unprobed|error
	HTTPStatus int    `json:"httpStatus,omitempty"`
	Latest     string `json:"latest,omitempty"`
	Detail     string `json:"detail,omitempty"`
}

type ReadinessSignal struct {
	RulesetVersion string `json:"rulesetVersion"`
	URL            string `json:"url"`

	// Stateless core (B2, B3): does the server answer without a handshake,
	// and does it implement the new required discovery RPC.
	StatelessAccepted bool     `json:"statelessAccepted"`
	DiscoverSupported bool     `json:"discoverSupported"`
	DiscoverVersions  []string `json:"discoverVersions,omitempty"`

	// Sessions (B1): whether the initialize response minted an
	// Mcp-Session-Id, and whether requests are rejected without it.
	SessionIssued   bool `json:"sessionIssued"`
	SessionRequired bool `json:"sessionRequired"`

	// Streams (B4, D2): the new listen RPC, and what a plain GET returns.
	// "legacy-sse" means the pre-Streamable-HTTP endpoint event was seen.
	SubscriptionsListen bool   `json:"subscriptionsListen"`
	GetStream           string `json:"getStream,omitempty"` // legacy-sse|sse|405|other

	// Capability-derived (B6, D1).
	TasksExperimental bool `json:"tasksExperimental"`
	LoggingDeclared   bool `json:"loggingDeclared"`

	// tools/list result conformance (B8, B11). Advisory, never verdict-blocking.
	ResultTypePresent bool `json:"resultTypePresent"`
	CacheMetaPresent  bool `json:"cacheMetaPresent"`

	// Routing headers (B10, B13). The enforced values record which numeric
	// code came back, distinguishing RC-beta builds from final builds.
	HeaderEnforcement string `json:"headerEnforcement,omitempty"` // enforced-32020|enforced-32001|ignored|unknown

	// Resource error code migration (B12). 0 when not tested (no resources
	// capability declared).
	ResourceNotFoundCode int `json:"resourceNotFoundCode,omitempty"`

	// Auth metadata (A1): public RFC 9728 protected-resource metadata.
	ProtectedResourceMetadata bool `json:"protectedResourceMetadata"`

	// Declared layer (D2): the transport the registry declares for this
	// remote, verdict-bearing when it is the deprecated "sse".
	DeclaredTransport string `json:"declaredTransport,omitempty"`

	Verdict  string   `json:"verdict"`
	Reasons  []string `json:"reasons,omitempty"`
	Warnings []string `json:"warnings,omitempty"`
}

type RemoteSignal struct {
	URL         string `json:"url"`
	Type        string `json:"type,omitempty"`
	Status      string `json:"status"` // reachable|unreachable|server_error|not_found
	HTTPStatus  int    `json:"httpStatus,omitempty"`
	Conformance string `json:"conformance,omitempty"` // initialize_ok|auth_gated|reachable_nonconformant
	Probe       string `json:"probe,omitempty"`       // get|initialize
	IDEchoed    *bool  `json:"idEchoed,omitempty"`    // did the initialize response echo the JSON-RPC id
	Detail      string `json:"detail,omitempty"`
	// tools/list probe, run with the official MCP client after a conformant
	// initialize. A completed session that lists tools is the strongest keyless
	// proof that this is a real, working MCP server.
	ToolsStatus string   `json:"toolsStatus,omitempty"` // ok|empty|error|connect_failed
	ToolCount   int      `json:"toolCount,omitempty"`
	ToolNames   []string `json:"toolNames,omitempty"`
	// initialize-response evidence, persisted only on a conformant handshake
	// (Conformance == initialize_ok). These are the raw observables a spec-
	// readiness classification is computed from downstream; the probe records,
	// it does not judge.
	ProtocolVersion string   `json:"protocolVersion,omitempty"` // version the server answered with
	Capabilities    []string `json:"capabilities,omitempty"`    // sorted top-level server capability keys
	SessionIssued   *bool    `json:"sessionIssued,omitempty"`   // response carried an Mcp-Session-Id header
	// contains filtered or unexported fields
}

type RepoSignal struct {
	Kind       string `json:"kind"`   // github|other|none
	Status     string `json:"status"` // alive|archived|missing|error|unprobed|none
	HTTPStatus int    `json:"httpStatus,omitempty"`
	Archived   bool   `json:"archived,omitempty"`
	PushedAt   string `json:"pushedAt,omitempty"`
	AgeDays    *int   `json:"ageDays,omitempty"`
	Stars      *int   `json:"stars,omitempty"`
	License    string `json:"license,omitempty"`
	URL        string `json:"url,omitempty"`
	Detail     string `json:"detail,omitempty"`
}

type Result struct {
	Name              string   `json:"name"`
	Title             string   `json:"title,omitempty"`
	Description       string   `json:"description,omitempty"`
	RegistryStatus    string   `json:"registryStatus,omitempty"`
	Version           string   `json:"version,omitempty"`
	Verdict           Verdict  `json:"verdict"`
	Reasons           []string `json:"reasons"`
	Checks            []Check  `json:"checks"`
	Signals           Signals  `json:"signals"`
	AliveEntrypoints  int      `json:"aliveEntrypoints"`
	ProbedEntrypoints int      `json:"probedEntrypoints"`
	CheckedAt         string   `json:"checkedAt"` // YYYY-MM-DD, UTC
	// Readiness is the 2026-07-28 spec-readiness pass, run against the first
	// conformant remote. Nil when the server has no keylessly reachable MCP
	// endpoint: that is the "unknown" bucket, absence of evidence recorded as
	// absence. Orthogonal to Verdict, which stays a pure health measure.
	Readiness *ReadinessSignal `json:"readiness,omitempty"`
}

type ServerJSONSignal struct {
	Status string   `json:"status"` // valid|invalid|no_schema|absent|error
	Schema string   `json:"schema,omitempty"`
	Errors []string `json:"errors,omitempty"`
}

type Signals struct {
	Repo       RepoSignal       `json:"repo"`
	Packages   []PackageSignal  `json:"packages"`
	Remotes    []RemoteSignal   `json:"remotes"`
	ServerJSON ServerJSONSignal `json:"serverJson"`
}

type Status string

type Verdict string