mcpserver

type ContributorOutput struct {
	ID             string `json:"id"`
	Type           string `json:"type,omitempty"`
	FullName       string `json:"fullName,omitempty"`
	Bibliographic  bool   `json:"bibliographic"`
	Permission     string `json:"permission,omitempty"`
	ProfileSelfURL string `json:"profileSelfUrl,omitempty"`
}

type ContributorsResult struct {
	Contributors []ContributorOutput `json:"contributors"`
}

type DOIInput struct {
	Identifier string `json:"identifier" jsonschema:"DOI, doi.org URL, or OSF DOI URL"`
}

type DOIResult struct {
	DOI         string `json:"doi"`
	ResolvedURL string `json:"resolvedUrl"`
}

type EmptyInput struct{}

type FileInput struct {
	ID string `json:"id" jsonschema:"OSF file id"`
}

type FileOutput struct {
	ID          string `json:"id"`
	Type        string `json:"type,omitempty"`
	Name        string `json:"name,omitempty"`
	Kind        string `json:"kind,omitempty"`
	Size        int64  `json:"size,omitempty"`
	MD5         string `json:"md5,omitempty"`
	SelfURL     string `json:"selfUrl,omitempty"`
	DownloadURL string `json:"downloadUrl,omitempty"`
}

type FileVersionOutput struct {
	ID           string    `json:"id"`
	Type         string    `json:"type,omitempty"`
	Size         int64     `json:"size,omitempty"`
	DateCreated  time.Time `json:"dateCreated,omitempty"`
	DateModified time.Time `json:"dateModified,omitempty"`
	SelfURL      string    `json:"selfUrl,omitempty"`
}

type FileVersionsResult struct {
	Versions []FileVersionOutput `json:"versions"`
}

type FilesInput struct {
	ID   string `json:"id" jsonschema:"OSF project/component id or URL"`
	Path string `json:"path,omitempty" jsonschema:"optional path below OSF Storage"`
}

type FilesResult struct {
	Files []FileOutput `json:"files"`
}

type NodeInput struct {
	ID string `json:"id" jsonschema:"OSF project/component id or URL"`
}

type NodeOutput struct {
	ID          string `json:"id"`
	Type        string `json:"type,omitempty"`
	Title       string `json:"title,omitempty"`
	Description string `json:"description,omitempty"`
	Category    string `json:"category,omitempty"`
	SelfURL     string `json:"selfUrl,omitempty"`
}

type NodeResult struct {
	Node NodeOutput `json:"node"`
}

type NodesResult struct {
	Nodes []NodeOutput `json:"nodes"`
}

type OAIFormatsInput struct {
	Identifier string `json:"identifier,omitempty" jsonschema:"optional OAI identifier"`
}

type OAIFormatsResult struct {
	Formats []zenodooai.MetadataFormat `json:"formats"`
}

type OAIRecordOutput struct {
	Identifier        string               `json:"identifier"`
	Datestamp         string               `json:"datestamp"`
	SetSpecs          []string             `json:"setSpecs,omitempty"`
	Deleted           bool                 `json:"deleted,omitempty"`
	NativeMetadataXML string               `json:"nativeMetadataXml,omitempty"`
	AboutXML          string               `json:"aboutXml,omitempty"`
	Provenance        zenodooai.Provenance `json:"provenance"`
}

type OAIRecordsInput struct {
	MetadataPrefix  string `json:"metadataPrefix,omitempty" jsonschema:"OAI metadata prefix; defaults to oai_dc"`
	Set             string `json:"set,omitempty" jsonschema:"optional OAI set spec"`
	From            string `json:"from,omitempty" jsonschema:"inclusive RFC3339 or YYYY-MM-DD start"`
	Until           string `json:"until,omitempty" jsonschema:"inclusive RFC3339 or YYYY-MM-DD end"`
	ResumptionToken string `json:"resumptionToken,omitempty" jsonschema:"opaque token from a prior page; exclusive with set/from/until"`
}

type OAIRecordsResult struct {
	Records []OAIRecordOutput          `json:"records"`
	Next    *zenodooai.ResumptionToken `json:"next,omitempty"`
}

type OAISetsResult struct {
	Sets []zenodooai.Set `json:"sets"`
}

type OSFClient interface {
	CurrentUser(context.Context) (osfapi.User, error)
	ListCurrentUserProjects(context.Context) ([]osfapi.Node, error)
	GetNode(context.Context, string) (osfapi.Node, error)
	ListNodeChildren(context.Context, string) ([]osfapi.Node, error)
	ListNodeContributors(context.Context, string) ([]osfapi.Contributor, error)
	ListStorageFiles(context.Context, string, ...string) ([]osfapi.StorageFile, error)
	ListFileVersions(context.Context, string) ([]osfapi.FileVersion, error)
	ListNodeAddons(context.Context, string) ([]osfapi.Node, error)
	ListWikiPages(context.Context, string) ([]osfapi.RelatedResource, error)
	ListNodeComments(context.Context, string) ([]osfapi.RelatedResource, error)
	ListNodeLogs(context.Context, string) ([]osfapi.RelatedResource, error)
	ListNodeIdentifiers(context.Context, string) ([]osfapi.RelatedResource, error)
	SearchOSF(context.Context, string, ...int) ([]osfapi.SearchResult, error)
	ListPreprints(context.Context, string, ...int) ([]osfapi.Node, error)
	SearchPreprints(context.Context, string, string, ...int) ([]osfapi.Preprint, error)
	ResolveDOI(context.Context, string) (osfapi.DOIResolution, error)
}

type Options struct {
	Version    string
	Events     observability.Emitter
	ZenodoOAI  ZenodoOAIClient
	ZenodoREST ZenodoRESTClient
}

type PreprintOutput struct {
	ID            string `json:"id"`
	Type          string `json:"type,omitempty"`
	Title         string `json:"title,omitempty"`
	DatePublished string `json:"datePublished,omitempty"`
	Published     bool   `json:"published"`
	DOI           string `json:"doi,omitempty"`
	URL           string `json:"url,omitempty"`
	Source        string `json:"source"`
}

type PreprintSearchInput struct {
	Query    string `json:"query" jsonschema:"title search query"`
	Provider string `json:"provider,omitempty" jsonschema:"optional preprint provider filter"`
	Limit    int    `json:"limit,omitempty" jsonschema:"maximum number of results; zero uses the server default"`
}

type PreprintsInput struct {
	Provider string `json:"provider,omitempty" jsonschema:"optional preprint provider filter"`
	Limit    int    `json:"limit,omitempty" jsonschema:"maximum number of results; zero uses the server default"`
}

type PreprintsResult struct {
	Preprints []PreprintOutput `json:"preprints"`
}

type ProviderInput struct {
	Provider string `json:"provider" jsonschema:"repository provider: osf or zenodo"`
}

type RelatedResourceOutput struct {
	ID         string         `json:"id"`
	Type       string         `json:"type,omitempty"`
	Attributes map[string]any `json:"attributes,omitempty"`
	SelfURL    string         `json:"selfUrl,omitempty"`
}

type RelatedResourcesResult struct {
	Resources []RelatedResourceOutput `json:"resources"`
}

type RepositoryCapabilitiesResult struct {
	Contract repository.Contract `json:"contract"`
}

type SearchInput struct {
	Query string `json:"query" jsonschema:"OSF search query"`
	Limit int    `json:"limit,omitempty" jsonschema:"maximum number of results; zero uses the server default"`
}

type SearchResult struct {
	ID          string   `json:"id"`
	Type        string   `json:"type,omitempty"`
	Title       string   `json:"title,omitempty"`
	Description string   `json:"description,omitempty"`
	Category    string   `json:"category,omitempty"`
	URL         string   `json:"url,omitempty"`
	Keywords    []string `json:"keywords,omitempty"`
	Year        string   `json:"year,omitempty"`
}

type SearchResults struct {
	Results []SearchResult `json:"results"`
}

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

type UserOutput struct {
	ID       string `json:"id"`
	Type     string `json:"type,omitempty"`
	FullName string `json:"fullName,omitempty"`
	SelfURL  string `json:"selfUrl,omitempty"`
}

type UserResult struct {
	User UserOutput `json:"user"`
}

type ZenodoFileOutput struct {
	QualifiedID       string            `json:"qualifiedId,omitempty"`
	RecordQualifiedID string            `json:"recordQualifiedId"`
	ID                string            `json:"id,omitempty"`
	Key               string            `json:"key"`
	Size              int64             `json:"size,omitempty"`
	Checksum          string            `json:"checksum,omitempty"`
	DownloadURL       string            `json:"downloadUrl,omitempty"`
	Links             map[string]string `json:"links,omitempty"`
}

type ZenodoFilesResult struct {
	Files []ZenodoFileOutput `json:"files"`
}

type ZenodoOAIClient interface {
	ListRecords(context.Context, zenodooai.Request) (zenodooai.Page, error)
	ListSets(context.Context) ([]zenodooai.Set, error)
	ListMetadataFormats(context.Context, string) ([]zenodooai.MetadataFormat, error)
}

type ZenodoRESTClient interface {
	SearchRecords(context.Context, string, int) ([]zenodoapi.Record, error)
	GetRecord(context.Context, string) (zenodoapi.Record, error)
	ListRecordFiles(context.Context, string) ([]zenodoapi.File, error)
}

type ZenodoRecordInput struct {
	ID string `json:"id" jsonschema:"native decimal id, zenodo:record:id, or canonical Zenodo record URL"`
}

type ZenodoRecordOutput struct {
	QualifiedID        string                  `json:"qualifiedId"`
	Provider           repository.Provider     `json:"provider"`
	Kind               repository.ResourceKind `json:"kind"`
	ID                 string                  `json:"id"`
	ConceptID          string                  `json:"conceptId,omitempty"`
	Title              string                  `json:"title"`
	Description        string                  `json:"description,omitempty"`
	DOI                string                  `json:"doi,omitempty"`
	ConceptDOI         string                  `json:"conceptDoi,omitempty"`
	Creators           []zenodoapi.Creator     `json:"creators,omitempty"`
	Keywords           []string                `json:"keywords,omitempty"`
	AccessRight        string                  `json:"accessRight,omitempty"`
	License            string                  `json:"license,omitempty"`
	Created            string                  `json:"created,omitempty"`
	Updated            string                  `json:"updated,omitempty"`
	Links              map[string]string       `json:"links,omitempty"`
	NativeMetadataJSON string                  `json:"nativeMetadataJson"`
}

type ZenodoRecordResult struct {
	Record ZenodoRecordOutput `json:"record"`
}

type ZenodoRecordsResult struct {
	Records []ZenodoRecordOutput `json:"records"`
}

type ZenodoSearchInput struct {
	Query string `json:"query,omitempty" jsonschema:"optional Zenodo record search query"`
	Limit int    `json:"limit,omitempty" jsonschema:"maximum results from 1 to 100; zero defaults to 10"`
}