mcp

type CallToolResult struct {
	Content []Content `json:"content"`
	IsError bool      `json:"isError,omitempty"`
}

type CheckToolInput struct {
	ServerName        string
	ServerIdentity    string
	ToolName          string
	RequestedAutonomy PermissionAutonomy
}

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

type Content struct {
	Type string `json:"type"`
	Text string `json:"text,omitempty"`
}

type GrantServerInput struct {
	ServerName     string
	ServerIdentity string
	MaxAutonomy    PermissionAutonomy
}

type GrantToolInput struct {
	ServerName     string
	ServerIdentity string
	ToolName       string
	MaxAutonomy    PermissionAutonomy
}

type LoginOptions struct {
	ServerName string
	ServerURL  string
	Config     OAuthConfig
	HTTPClient *http.Client
	// OpenBrowser is invoked with the authorization URL. The default prints the
	// URL; tests inject a function that drives the loopback redirect.
	OpenBrowser func(authURL string) error
	Timeout     time.Duration
	Now         func() time.Time
}

type OAuthConfig struct {
	ClientID              string
	ClientSecret          string
	Scopes                []string
	AuthorizationEndpoint string
	TokenEndpoint         string
	RegistrationEndpoint  string
	// IssuerURL overrides the base URL used for metadata discovery. When empty
	// the MCP server URL is used.
	IssuerURL string
}

type PermissionAutonomy string

type PermissionGrant struct {
	Scope          PermissionScope    `json:"scope"`
	ServerName     string             `json:"serverName"`
	ServerIdentity string             `json:"serverIdentity"`
	ToolName       string             `json:"toolName,omitempty"`
	MaxAutonomy    PermissionAutonomy `json:"maxAutonomy"`
	ApprovedAt     string             `json:"approvedAt"`
}

type PermissionScope string

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

type Prompt struct {
	Name        string           `json:"name"`
	Description string           `json:"description"`
	Arguments   []PromptArgument `json:"arguments,omitempty"`
}

type PromptArgument struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
}

type PromptMessage struct {
	Role    string               `json:"role"`
	Content PromptMessageContent `json:"content"`
}

type PromptMessageContent struct {
	Type string `json:"type"`
	Text string `json:"text"`
}

type RegisterOptions struct {
	PermissionStore *PermissionStore
	Autonomy        PermissionAutonomy
	ClientFactory   func(context.Context, Server) (ToolClient, error)
	// ConnectTimeout bounds the per-server connect+list at startup. Zero uses
	// defaultConnectTimeout.
	ConnectTimeout time.Duration
}

type RemoteTool struct {
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	InputSchema map[string]any `json:"inputSchema,omitempty"`
}

type Resource struct {
	URI         string `json:"uri"`
	Name        string `json:"name"`
	MimeType    string `json:"mimeType,omitempty"`
	Description string `json:"description,omitempty"`
}

type ResourceContents struct {
	URI      string `json:"uri"`
	MimeType string `json:"mimeType,omitempty"`
	Text     string `json:"text,omitempty"`
	Blob     string `json:"blob,omitempty"`
}

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

type ServeOptions struct {
	Name              string
	Version           string
	PermissionGranted bool
	// WorkspaceRoot is the directory whose files are exposed as MCP resources.
	// Empty means the process working directory. Resource reads are confined to
	// this root (and any extra Scope roots).
	WorkspaceRoot string
	// Scope, when set, widens the resource roots beyond WorkspaceRoot using the
	// same multi-root scoping the sandbox/file tools use. nil means
	// workspace-only.
	Scope tools.PathScope
}

type Server struct {
	Name     string
	Type     ServerType
	Command  string
	Args     []string
	Env      map[string]string
	URL      string
	Headers  map[string]string
	Auth     string
	OAuth    *OAuthConfig
	Identity string
	// UnconfiguredDefault is true when this server is one of Zero's built-in
	// defaults (e.g. keyless Firecrawl) that the user never touched in their
	// config — no credentials, no overrides. Callers use it to avoid warning
	// loudly when a server nobody configured fails to connect.
	UnconfiguredDefault bool
}

type ServerType string

type SkippedServer struct {
	Name string
	Err  error
	// UnconfiguredDefault mirrors Server.UnconfiguredDefault: true when this
	// server is an out-of-the-box default the user never configured, so a
	// caller can skip warning loudly about it.
	UnconfiguredDefault bool
}

type StoreOptions struct {
	FilePath string
	Now      func() time.Time
	Env      map[string]string
}

type StoredToken struct {
	AccessToken  string    `json:"access_token"`
	RefreshToken string    `json:"refresh_token,omitempty"`
	TokenType    string    `json:"token_type,omitempty"`
	Scopes       []string  `json:"scopes,omitempty"`
	ExpiresAt    time.Time `json:"expires_at,omitempty"`
}

type TokenStatus struct {
	ServerName      string    `json:"serverName"`
	HasToken        bool      `json:"hasToken"`
	HasRefreshToken bool      `json:"hasRefreshToken"`
	TokenType       string    `json:"tokenType,omitempty"`
	Scopes          []string  `json:"scopes,omitempty"`
	ExpiresAt       time.Time `json:"expiresAt,omitempty"`
	Expired         bool      `json:"expired"`
}

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

type TokenStoreOptions struct {
	FilePath   string
	LegacyPath string
	Env        map[string]string
	Now        func() time.Time
}

type ToolClient interface {
	ListTools(context.Context) ([]RemoteTool, error)
	CallTool(context.Context, string, map[string]any) (CallToolResult, error)
	Close() error
}