@cyanheads/zenodo-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,721 @@
+/**
+ * @fileoverview Barrel of every tool definition this server registers.
+ * @module mcp-server/tools/definitions
+ */
+import { getRecord } from './get-record.tool.js';
+import { listFiles } from './list-files.tool.js';
+import { listVersions } from './list-versions.tool.js';
+import { lookupVocabulary } from './lookup-vocabulary.tool.js';
+import { readFile } from './read-file.tool.js';
+import { searchRecords } from './search-records.tool.js';
+export { getRecord, listFiles, listVersions, lookupVocabulary, readFile, searchRecords };
+/** All tool definitions, in registration order. */
+export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    size: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    found: import("zod").ZodBoolean;
+    input_kind: import("zod").ZodEnum<{
+        external_doi: "external_doi";
+        record_id: "record_id";
+        url: "url";
+        zenodo_doi: "zenodo_doi";
+    }>;
+    miss_kind: import("zod").ZodOptional<import("zod").ZodEnum<{
+        deleted: "deleted";
+        not_found: "not_found";
+        not_on_zenodo: "not_on_zenodo";
+        restricted: "restricted";
+    }>>;
+    guidance: import("zod").ZodOptional<import("zod").ZodString>;
+    tombstone: import("zod").ZodOptional<import("zod").ZodObject<{
+        removal_date: import("zod").ZodOptional<import("zod").ZodString>;
+        removal_reason: import("zod").ZodOptional<import("zod").ZodString>;
+        note: import("zod").ZodOptional<import("zod").ZodString>;
+        citation_text: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    concept_recid: import("zod").ZodOptional<import("zod").ZodString>;
+    concept_doi: import("zod").ZodOptional<import("zod").ZodString>;
+    total_versions: import("zod").ZodOptional<import("zod").ZodNumber>;
+    latest_recid: import("zod").ZodOptional<import("zod").ZodString>;
+    page: import("zod").ZodNumber;
+    size: import("zod").ZodNumber;
+    has_more: import("zod").ZodBoolean;
+    next_page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    versions: import("zod").ZodArray<import("zod").ZodObject<{
+        recid: import("zod").ZodString;
+        doi: import("zod").ZodOptional<import("zod").ZodString>;
+        version: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodString;
+        publication_date: import("zod").ZodOptional<import("zod").ZodString>;
+        index: import("zod").ZodOptional<import("zod").ZodNumber>;
+        is_latest: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        file_count: import("zod").ZodOptional<import("zod").ZodNumber>;
+        total_bytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+        views: import("zod").ZodOptional<import("zod").ZodNumber>;
+        downloads: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "invalid_identifier";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host";
+    readonly recovery: "Pass a Zenodo record id (22705923), a DOI (10.5281/zenodo.22705923), or a zenodo.org/records URL as id; for a title or keyword, use zenodo_search_records.";
+}, {
+    readonly reason: "result_window_exceeded";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "page × size exceeds 10,000";
+    readonly recovery: "Zenodo pages only the first 10,000 versions of a series, and no series comes near that; call zenodo_list_versions with page 1 (total_versions and has_more show how far the series goes).";
+}, {
+    readonly reason: "record_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo could not serve this record or its versions page: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete record response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit)";
+    readonly thrownBy: "service";
+    readonly recovery: "Look the record up with zenodo_search_records using query doi:\"<its DOI>\" (all_versions true) or its title; withdrawn legacy records and deposits with more than about 10,000 files fail on the record endpoint, and if a keyword search also fails, Zenodo is degraded.";
+}, {
+    readonly reason: "upstream_timeout";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Timeout;
+    readonly when: "The versions page got no complete response within its time budget";
+    readonly retryable: false;
+    readonly thrownBy: "service";
+    readonly recovery: "Call zenodo_list_versions again with a smaller size (5); this series holds large file manifests.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_list_versions again with the same arguments.";
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+    readonly totalCount: import("zod").ZodNumber;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    query: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    resource_type: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        [x: string]: string;
+    }>>>, unknown>;
+    community: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    funder: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    award: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    creator_orcid: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    file_type: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
+    license: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    access_status: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
+        embargoed: "embargoed";
+        "metadata-only": "metadata-only";
+        open: "open";
+        restricted: "restricted";
+    }>>, unknown>;
+    published_from: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    published_to: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    all_versions: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    sort: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
+        bestmatch: "bestmatch";
+        mostdownloaded: "mostdownloaded";
+        mostviewed: "mostviewed";
+        newest: "newest";
+        oldest: "oldest";
+        "updated-asc": "updated-asc";
+        "updated-desc": "updated-desc";
+    }>>, unknown>;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    size: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    total: import("zod").ZodNumber;
+    reachable: import("zod").ZodNumber;
+    page: import("zod").ZodNumber;
+    size: import("zod").ZodNumber;
+    has_more: import("zod").ZodBoolean;
+    next_page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    hits: import("zod").ZodArray<import("zod").ZodObject<{
+        recid: import("zod").ZodString;
+        doi: import("zod").ZodOptional<import("zod").ZodString>;
+        doi_provider: import("zod").ZodOptional<import("zod").ZodString>;
+        concept_recid: import("zod").ZodOptional<import("zod").ZodString>;
+        concept_doi: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodString;
+        publication_date: import("zod").ZodOptional<import("zod").ZodString>;
+        resource_type: import("zod").ZodOptional<import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            title: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        version: import("zod").ZodOptional<import("zod").ZodString>;
+        is_latest: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        version_index: import("zod").ZodOptional<import("zod").ZodNumber>;
+        creators: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            orcid: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        creator_count: import("zod").ZodNumber;
+        license_ids: import("zod").ZodArray<import("zod").ZodString>;
+        access: import("zod").ZodObject<{
+            status: import("zod").ZodString;
+            files: import("zod").ZodOptional<import("zod").ZodString>;
+            embargo_until: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        communities: import("zod").ZodArray<import("zod").ZodString>;
+        file_count: import("zod").ZodOptional<import("zod").ZodNumber>;
+        total_bytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+        views: import("zod").ZodOptional<import("zod").ZodNumber>;
+        downloads: import("zod").ZodOptional<import("zod").ZodNumber>;
+        description_snippet: import("zod").ZodOptional<import("zod").ZodString>;
+        zenodo_url: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    facets: import("zod").ZodObject<{
+        resource_type: import("zod").ZodArray<import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            label: import("zod").ZodString;
+            count: import("zod").ZodNumber;
+            subtypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                label: import("zod").ZodString;
+                count: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>>>;
+        }, import("zod/v4/core").$strip>>;
+        access_status: import("zod").ZodArray<import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            label: import("zod").ZodString;
+            count: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>>;
+        file_type: import("zod").ZodArray<import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            label: import("zod").ZodString;
+            count: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>>;
+        subject: import("zod").ZodArray<import("zod").ZodObject<{
+            label: import("zod").ZodString;
+            count: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>>;
+        publication_year: import("zod").ZodArray<import("zod").ZodObject<{
+            year: import("zod").ZodString;
+            count: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "query_is_identifier";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The query is a single DOI, doi.org URL, or zenodo.org record URL";
+    readonly recovery: "Pass this identifier to zenodo_get_record as id instead of searching for it.";
+}, {
+    readonly reason: "query_syntax";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The query has an unpaired unescaped / outside quotes";
+    readonly recovery: "Escape the slash as \\/ or wrap that term in double quotes, then call zenodo_search_records again.";
+}, {
+    readonly reason: "query_failed";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo answered HTTP 500 for a query that passed the local checks";
+    readonly retryable: false;
+    readonly thrownBy: "service";
+    readonly recovery: "Simplify the query (quote phrases, escape : and / with a backslash, or move identifiers into the dedicated filters) and call zenodo_search_records again; if a plain keyword query also fails, Zenodo is degraded, so retry in a few minutes.";
+}, {
+    readonly reason: "upstream_timeout";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Timeout;
+    readonly when: "The search attempt got no complete response within its time budget";
+    readonly retryable: false;
+    readonly thrownBy: "service";
+    readonly recovery: "Call zenodo_search_records again with a smaller size (5) or narrower filters so the page holds fewer large deposits.";
+}, {
+    readonly reason: "unknown_community";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "community resolves to no Zenodo community";
+    readonly recovery: "Find the community’s slug with zenodo_lookup_vocabulary (vocabulary: communities), then pass it as community.";
+}, {
+    readonly reason: "unknown_funder";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "funder is not a known ROR id and no funder carries that Crossref Funder DOI";
+    readonly recovery: "Resolve the funder with zenodo_lookup_vocabulary (vocabulary: funders) and pass the returned ROR id as funder.";
+}, {
+    readonly reason: "invalid_date_range";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The expanded published_from is after published_to";
+    readonly recovery: "Set published_from to a date on or before published_to and call zenodo_search_records again.";
+}, {
+    readonly reason: "result_window_exceeded";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "page × size exceeds 10,000";
+    readonly recovery: "Zenodo serves only the first 10,000 matches; add filters or a published_from/published_to range to zenodo_search_records instead of paging deeper.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_search_records again with the same arguments.";
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+    readonly totalCount: import("zod").ZodNumber;
+    readonly effectiveQuery: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly appliedSort: import("zod").ZodEnum<{
+        bestmatch: "bestmatch";
+        mostdownloaded: "mostdownloaded";
+        mostviewed: "mostviewed";
+        newest: "newest";
+        oldest: "oldest";
+        "updated-asc": "updated-asc";
+        "updated-desc": "updated-desc";
+    }>;
+    readonly allVersions: import("zod").ZodBoolean;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    citation_style: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
+        apa: "apa";
+        bibtex: "bibtex";
+        "chicago-author-date": "chicago-author-date";
+        "csl-json": "csl-json";
+        "harvard-cite-them-right": "harvard-cite-them-right";
+        ieee: "ieee";
+        "modern-language-association": "modern-language-association";
+        nature: "nature";
+    }>>, unknown>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    found: import("zod").ZodBoolean;
+    input_kind: import("zod").ZodEnum<{
+        external_doi: "external_doi";
+        record_id: "record_id";
+        url: "url";
+        zenodo_doi: "zenodo_doi";
+    }>;
+    resolved_from: import("zod").ZodOptional<import("zod").ZodEnum<{
+        concept_to_latest: "concept_to_latest";
+        external_doi: "external_doi";
+        version: "version";
+    }>>;
+    miss_kind: import("zod").ZodOptional<import("zod").ZodEnum<{
+        deleted: "deleted";
+        not_found: "not_found";
+        not_on_zenodo: "not_on_zenodo";
+        restricted: "restricted";
+    }>>;
+    guidance: import("zod").ZodOptional<import("zod").ZodString>;
+    tombstone: import("zod").ZodOptional<import("zod").ZodObject<{
+        removal_date: import("zod").ZodOptional<import("zod").ZodString>;
+        removal_reason: import("zod").ZodOptional<import("zod").ZodString>;
+        note: import("zod").ZodOptional<import("zod").ZodString>;
+        citation_text: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    record: import("zod").ZodOptional<import("zod").ZodObject<{
+        recid: import("zod").ZodString;
+        concept_recid: import("zod").ZodOptional<import("zod").ZodString>;
+        doi: import("zod").ZodOptional<import("zod").ZodString>;
+        doi_provider: import("zod").ZodOptional<import("zod").ZodString>;
+        concept_doi: import("zod").ZodOptional<import("zod").ZodString>;
+        oai_id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodString;
+        publication_date: import("zod").ZodOptional<import("zod").ZodString>;
+        version: import("zod").ZodOptional<import("zod").ZodString>;
+        publisher: import("zod").ZodOptional<import("zod").ZodString>;
+        resource_type: import("zod").ZodOptional<import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            title: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        description_truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        description_length: import("zod").ZodOptional<import("zod").ZodNumber>;
+        additional_descriptions: import("zod").ZodArray<import("zod").ZodObject<{
+            type: import("zod").ZodOptional<import("zod").ZodString>;
+            text: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+        creators: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodOptional<import("zod").ZodString>;
+            orcid: import("zod").ZodOptional<import("zod").ZodString>;
+            role: import("zod").ZodOptional<import("zod").ZodString>;
+            affiliations: import("zod").ZodArray<import("zod").ZodObject<{
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                ror: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>>;
+        creator_count: import("zod").ZodNumber;
+        contributors: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodOptional<import("zod").ZodString>;
+            orcid: import("zod").ZodOptional<import("zod").ZodString>;
+            role: import("zod").ZodOptional<import("zod").ZodString>;
+            affiliations: import("zod").ZodArray<import("zod").ZodObject<{
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                ror: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>>;
+        contributor_count: import("zod").ZodNumber;
+        keywords: import("zod").ZodArray<import("zod").ZodString>;
+        rights: import("zod").ZodArray<import("zod").ZodObject<{
+            id: import("zod").ZodOptional<import("zod").ZodString>;
+            title: import("zod").ZodString;
+            url: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        access: import("zod").ZodObject<{
+            status: import("zod").ZodString;
+            record: import("zod").ZodOptional<import("zod").ZodString>;
+            files: import("zod").ZodOptional<import("zod").ZodString>;
+            embargo_active: import("zod").ZodBoolean;
+            embargo_until: import("zod").ZodOptional<import("zod").ZodString>;
+            embargo_reason: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        funding: import("zod").ZodArray<import("zod").ZodObject<{
+            funder_id: import("zod").ZodOptional<import("zod").ZodString>;
+            funder_name: import("zod").ZodOptional<import("zod").ZodString>;
+            award_id: import("zod").ZodOptional<import("zod").ZodString>;
+            award_number: import("zod").ZodOptional<import("zod").ZodString>;
+            award_acronym: import("zod").ZodOptional<import("zod").ZodString>;
+            award_title: import("zod").ZodOptional<import("zod").ZodString>;
+            award_program: import("zod").ZodOptional<import("zod").ZodString>;
+            award_doi: import("zod").ZodOptional<import("zod").ZodString>;
+            award_url: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        related_identifiers: import("zod").ZodArray<import("zod").ZodObject<{
+            identifier: import("zod").ZodString;
+            scheme: import("zod").ZodOptional<import("zod").ZodString>;
+            relation: import("zod").ZodOptional<import("zod").ZodString>;
+            resource_type: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        related_identifier_count: import("zod").ZodNumber;
+        code_repository: import("zod").ZodOptional<import("zod").ZodString>;
+        communities: import("zod").ZodArray<import("zod").ZodObject<{
+            slug: import("zod").ZodString;
+            title: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        versions: import("zod").ZodObject<{
+            index: import("zod").ZodOptional<import("zod").ZodNumber>;
+            is_latest: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            latest_recid: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        stats: import("zod").ZodOptional<import("zod").ZodObject<{
+            this_version: import("zod").ZodObject<{
+                views: import("zod").ZodOptional<import("zod").ZodNumber>;
+                downloads: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+            all_versions: import("zod").ZodObject<{
+                views: import("zod").ZodOptional<import("zod").ZodNumber>;
+                downloads: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>>;
+        files: import("zod").ZodObject<{
+            enabled: import("zod").ZodBoolean;
+            count: import("zod").ZodOptional<import("zod").ZodNumber>;
+            total_bytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            shown: import("zod").ZodNumber;
+            entries: import("zod").ZodArray<import("zod").ZodObject<{
+                key: import("zod").ZodString;
+                size: import("zod").ZodOptional<import("zod").ZodNumber>;
+                mimetype: import("zod").ZodOptional<import("zod").ZodString>;
+                md5: import("zod").ZodOptional<import("zod").ZodString>;
+                download_url: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        revision: import("zod").ZodOptional<import("zod").ZodNumber>;
+        zenodo_url: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    citation: import("zod").ZodOptional<import("zod").ZodString>;
+    citation_style: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "invalid_identifier";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host";
+    readonly recovery: "Pass a Zenodo record id (22705923), a DOI (10.5281/zenodo.22705923), or a zenodo.org/records URL as id; for a title or keyword, use zenodo_search_records.";
+}, {
+    readonly reason: "record_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo could not serve this record: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit)";
+    readonly thrownBy: "service";
+    readonly recovery: "Look the record up with zenodo_search_records using query doi:\"<its DOI>\" (all_versions true) or its title; withdrawn legacy records and deposits with more than about 10,000 files fail on the record endpoint, and if a keyword search also fails, Zenodo is degraded.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_get_record again with the same arguments.";
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    archive_key: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    key_contains: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    recid: import("zod").ZodString;
+    kind: import("zod").ZodEnum<{
+        archive: "archive";
+        manifest: "manifest";
+    }>;
+    access_status: import("zod").ZodString;
+    files_access: import("zod").ZodOptional<import("zod").ZodString>;
+    embargo_until: import("zod").ZodOptional<import("zod").ZodString>;
+    files_enabled: import("zod").ZodBoolean;
+    key_contains: import("zod").ZodOptional<import("zod").ZodString>;
+    offset: import("zod").ZodNumber;
+    limit: import("zod").ZodNumber;
+    matched: import("zod").ZodNumber;
+    has_more: import("zod").ZodBoolean;
+    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    file_count: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total_bytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+    entries: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        size: import("zod").ZodOptional<import("zod").ZodNumber>;
+        mimetype: import("zod").ZodOptional<import("zod").ZodString>;
+        md5: import("zod").ZodOptional<import("zod").ZodString>;
+        download_url: import("zod").ZodString;
+        previewable: import("zod").ZodBoolean;
+        listable: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>>;
+    archive: import("zod").ZodOptional<import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        size: import("zod").ZodOptional<import("zod").ZodNumber>;
+        download_url: import("zod").ZodString;
+        listed_members: import("zod").ZodNumber;
+        upstream_truncated: import("zod").ZodBoolean;
+        directory_count: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    members: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        path: import("zod").ZodString;
+        size: import("zod").ZodOptional<import("zod").ZodNumber>;
+        compressed_size: import("zod").ZodOptional<import("zod").ZodNumber>;
+        mimetype: import("zod").ZodOptional<import("zod").ZodString>;
+        previewable: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "invalid_identifier";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host";
+    readonly recovery: "Pass a Zenodo record id (22705923), a DOI (10.5281/zenodo.22705923), or a zenodo.org/records URL as id; for a title or keyword, use zenodo_search_records.";
+}, {
+    readonly reason: "record_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The record 404s, its metadata is restricted, or a non-Zenodo DOI is not registered to a record";
+    readonly recovery: "Check the id with zenodo_get_record, or find the deposit with zenodo_search_records.";
+}, {
+    readonly reason: "record_deleted";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The record was deleted from Zenodo; only its removal tombstone remains";
+    readonly recovery: "Call zenodo_get_record with this id for the removal date and reason, then find a replacement deposit with zenodo_search_records.";
+}, {
+    readonly reason: "file_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "archive_key is not a key in the record, or Zenodo has no member listing for it";
+    readonly recovery: "Call zenodo_list_files without archive_key to see this record’s file keys.";
+}, {
+    readonly reason: "not_an_archive";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "archive_key is not a .zip";
+    readonly recovery: "Only .zip files can be listed; read a small text file with zenodo_read_file or fetch this file from its download_url.";
+}, {
+    readonly reason: "archive_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo cannot open the .zip named by archive_key: its member listing answered HTTP 500 after one retry, or no complete response arrived in time";
+    readonly thrownBy: "service";
+    readonly recovery: "Zenodo cannot list every .zip; download the archive from the URL in the error message (its download_url in the manifest) and list it locally, or read the record’s other files with zenodo_read_file.";
+}, {
+    readonly reason: "record_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo could not serve this record: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit)";
+    readonly thrownBy: "service";
+    readonly recovery: "Read the deposit’s metadata from zenodo_search_records with query doi:\"<its DOI>\" (all_versions true); withdrawn legacy records and deposits with more than about 10,000 files fail on the record endpoint, so their file manifest cannot be listed, and if a keyword search also fails, Zenodo is degraded.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_list_files again with the same arguments.";
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+    readonly totalCount: import("zod").ZodNumber;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    key: import("zod").ZodString;
+    archive_member: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    offset_bytes: import("zod").ZodDefault<import("zod").ZodNumber>;
+    max_bytes: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    recid: import("zod").ZodString;
+    key: import("zod").ZodString;
+    archive_member: import("zod").ZodOptional<import("zod").ZodString>;
+    status: import("zod").ZodEnum<{
+        empty: "empty";
+        not_text: "not_text";
+        restricted: "restricted";
+        text: "text";
+    }>;
+    mimetype: import("zod").ZodOptional<import("zod").ZodString>;
+    file_size: import("zod").ZodOptional<import("zod").ZodNumber>;
+    md5: import("zod").ZodOptional<import("zod").ZodString>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
+    offset_bytes: import("zod").ZodNumber;
+    bytes_returned: import("zod").ZodNumber;
+    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    has_more: import("zod").ZodBoolean;
+    replacement_chars: import("zod").ZodNumber;
+    rights: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    record_url: import("zod").ZodString;
+    download_url: import("zod").ZodString;
+    files_access: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "invalid_identifier";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host";
+    readonly recovery: "Pass a Zenodo record id (22705923), a DOI (10.5281/zenodo.22705923), or a zenodo.org/records URL as id; for a title or keyword, use zenodo_search_records.";
+}, {
+    readonly reason: "record_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The record 404s, its metadata is restricted, or a non-Zenodo DOI is not registered to a record";
+    readonly recovery: "Check the id with zenodo_get_record, or find the deposit with zenodo_search_records.";
+}, {
+    readonly reason: "record_deleted";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The record was deleted from Zenodo; only its removal tombstone remains";
+    readonly recovery: "Call zenodo_get_record with this id for the removal date and reason, then find a replacement deposit with zenodo_search_records.";
+}, {
+    readonly reason: "file_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "key is not in the record's manifest, or Zenodo serves no content for it";
+    readonly recovery: "Call zenodo_list_files with this id to see the record’s exact file keys.";
+}, {
+    readonly reason: "not_an_archive";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "archive_member is set but key is not a .zip";
+    readonly recovery: "Drop archive_member to read the file itself, or pick a .zip key from zenodo_list_files.";
+}, {
+    readonly reason: "member_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Zenodo has no member at archive_member inside the .zip";
+    readonly recovery: "Call zenodo_list_files with archive_key set to this key to see the member paths.";
+}, {
+    readonly reason: "member_offset_unsupported";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "offset_bytes is above 0 together with archive_member";
+    readonly recovery: "Read the member from offset_bytes 0 with a larger max_bytes (up to 65536), or download the archive from download_url.";
+}, {
+    readonly reason: "offset_out_of_range";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "offset_bytes is at or past the end of the file";
+    readonly recovery: "Call zenodo_read_file again with an offset_bytes below the file’s size (size in zenodo_list_files, file_size in a prior zenodo_read_file result).";
+}, {
+    readonly reason: "archive_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo cannot open the .zip named by key: its member listing or the member read answered HTTP 500 after one retry, or no complete response arrived in time";
+    readonly thrownBy: "service";
+    readonly recovery: "Zenodo cannot open every .zip; download the archive from the URL in the error message and extract the member locally, or read the record’s top-level files with zenodo_read_file.";
+}, {
+    readonly reason: "record_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo could not serve this record: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit)";
+    readonly thrownBy: "service";
+    readonly recovery: "Read the deposit’s metadata from zenodo_search_records with query doi:\"<its DOI>\" (all_versions true); withdrawn legacy records and deposits with more than about 10,000 files fail on the record endpoint, so their files cannot be read, and if a keyword search also fails, Zenodo is degraded.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_read_file again with the same arguments.";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    vocabulary: import("zod").ZodPreprocess<import("zod").ZodEnum<{
+        awards: "awards";
+        communities: "communities";
+        funders: "funders";
+        licenses: "licenses";
+        resource_types: "resource_types";
+    }>, unknown>;
+    query: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    funder: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    size: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    vocabulary: import("zod").ZodEnum<{
+        awards: "awards";
+        communities: "communities";
+        funders: "funders";
+        licenses: "licenses";
+        resource_types: "resource_types";
+    }>;
+    query: import("zod").ZodOptional<import("zod").ZodString>;
+    total: import("zod").ZodNumber;
+    page: import("zod").ZodNumber;
+    size: import("zod").ZodNumber;
+    has_more: import("zod").ZodBoolean;
+    next_page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    entries: import("zod").ZodArray<import("zod").ZodObject<{
+        filter_param: import("zod").ZodEnum<{
+            award: "award";
+            community: "community";
+            funder: "funder";
+            license: "license";
+            resource_type: "resource_type";
+        }>;
+        filter_value: import("zod").ZodString;
+        label: import("zod").ZodString;
+        slug: import("zod").ZodOptional<import("zod").ZodString>;
+        uuid: import("zod").ZodOptional<import("zod").ZodString>;
+        community_type: import("zod").ZodOptional<import("zod").ZodString>;
+        website: import("zod").ZodOptional<import("zod").ZodString>;
+        organizations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        ror_id: import("zod").ZodOptional<import("zod").ZodString>;
+        funder_doi: import("zod").ZodOptional<import("zod").ZodString>;
+        acronym: import("zod").ZodOptional<import("zod").ZodString>;
+        country: import("zod").ZodOptional<import("zod").ZodString>;
+        country_name: import("zod").ZodOptional<import("zod").ZodString>;
+        number: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        program: import("zod").ZodOptional<import("zod").ZodString>;
+        funder_id: import("zod").ZodOptional<import("zod").ZodString>;
+        funder_name: import("zod").ZodOptional<import("zod").ZodString>;
+        award_doi: import("zod").ZodOptional<import("zod").ZodString>;
+        award_url: import("zod").ZodOptional<import("zod").ZodString>;
+        start_date: import("zod").ZodOptional<import("zod").ZodString>;
+        end_date: import("zod").ZodOptional<import("zod").ZodString>;
+        url: import("zod").ZodOptional<import("zod").ZodString>;
+        osi_approved: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        parent_type: import("zod").ZodOptional<import("zod").ZodString>;
+        search_value: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "funder_only_for_awards";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "funder is set with a vocabulary other than awards";
+    readonly recovery: "Call zenodo_lookup_vocabulary again without funder, or set vocabulary to awards to scope grants by funder.";
+}, {
+    readonly reason: "unknown_funder";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "funder (awards) resolves to no Zenodo funder";
+    readonly recovery: "Resolve the funder first with zenodo_lookup_vocabulary (vocabulary: funders) and pass its ROR id as funder.";
+}, {
+    readonly reason: "result_window_exceeded";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "page × size exceeds 10,000";
+    readonly recovery: "Narrow the query and call zenodo_lookup_vocabulary again instead of paging past 10,000 entries.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_lookup_vocabulary again with the same arguments.";
+}], {
+    readonly truncated: import("zod").ZodBoolean;
+    readonly shown: import("zod").ZodNumber;
+    readonly cap: import("zod").ZodNumber;
+    readonly totalCount: import("zod").ZodNumber;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}>)[];
+//# sourceMappingURL=index.d.ts.map