/** * @fileoverview Extract outcomes, adverse events, participant flow, baseline, and results metadata from completed studies. * @module mcp-server/tools/definitions/get-study-results.tool */ import { z } from '@cyanheads/mcp-ts-core'; import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors'; export declare const getStudyResults: import("@cyanheads/mcp-ts-core").ToolDefinition]>; sections: z.ZodOptional, z.ZodArray>]>>; summary: z.ZodDefault; outcomeLimit: z.ZodOptional; adverseEventLimit: z.ZodOptional; outcomeOffset: z.ZodOptional; seriousEventOffset: z.ZodOptional; otherEventOffset: z.ZodOptional; }, z.core.$strip>, z.ZodObject<{ results: z.ZodArray; title: z.ZodString; hasResults: z.ZodBoolean; outcomes: z.ZodOptional>>; adverseEvents: z.ZodOptional>; participantFlow: z.ZodOptional>; baseline: z.ZodOptional>; moreInfo: z.ZodOptional>; filtersApplied: z.ZodOptional; outcomeLimit: z.ZodOptional; outcomeOffset: z.ZodOptional; nextOutcomeOffset: z.ZodOptional; totalSeriousEvents: z.ZodOptional; totalOtherEvents: z.ZodOptional; adverseEventLimit: z.ZodOptional; seriousEventOffset: z.ZodOptional; nextSeriousEventOffset: z.ZodOptional; otherEventOffset: z.ZodOptional; nextOtherEventOffset: z.ZodOptional; }, z.core.$strip>>; }, z.core.$strip>>; studiesWithoutResults: z.ZodOptional>; fetchErrors: z.ZodOptional>>; deferredNctIds: z.ZodOptional>; truncated: z.ZodOptional; }, z.core.$strip>, readonly [{ readonly reason: "blank_value"; readonly code: JsonRpcErrorCode.ValidationError; readonly when: "A parameter was supplied with a blank, whitespace-only, or empty-list value."; readonly recovery: "Supply a value containing non-whitespace, or for a list parameter at least one non-blank entry. Only when the parameter is optional and you meant to leave it unset, omit it entirely instead — omission and a blank value mean different things here."; }, { readonly reason: "offset_not_applicable"; readonly code: JsonRpcErrorCode.ValidationError; readonly when: "An offset was supplied for a list this call does not return as a window — an adverse-event offset in summary mode, which ranks the whole event list into topEvents, or any offset whose own section the sections filter excludes."; readonly recovery: "Drop the offset, or re-run with the offset’s own section named in sections — outcomes for outcomeOffset, adverseEvents for seriousEventOffset and otherEventOffset — and, for an event offset, summary: false."; }, { readonly reason: "rate_limited"; readonly code: JsonRpcErrorCode.RateLimited; readonly when: "ClinicalTrials.gov answered HTTP 429 on every attempt, or the call’s time budget ran out after a 429."; readonly recovery: "ClinicalTrials.gov rate-limited the request after several retries; wait about a minute before trying again."; readonly retryable: true; }, { readonly reason: "retry_deadline_exceeded"; readonly code: JsonRpcErrorCode.Timeout; readonly when: "ClinicalTrials.gov did not answer within the call’s time budget, which covers every request, retry, and wait the call makes — the batch and any per-ID fetches share it."; readonly recovery: "Retry after a minute or two. If the call asked for a lot at once — a large pageSize, many fields, or many nctIds — ask for less per call, or split the request across several calls."; readonly retryable: true; readonly thrownBy: "service"; }, { readonly reason: "upstream_timeout"; readonly code: JsonRpcErrorCode.Timeout; readonly when: "ClinicalTrials.gov answered HTTP 504 (gateway timeout) or 408 (request timeout), or sent no answer within the per-attempt timeout, on every attempt of the batch request."; readonly recovery: "Retry after a few minutes. If it fails again, narrow the request — a more specific query or filter, a smaller pageSize, or fewer fields or nctIds — so ClinicalTrials.gov has less to compute and return."; readonly retryable: true; readonly thrownBy: "service"; }, { readonly reason: "upstream_unavailable"; readonly code: JsonRpcErrorCode.ServiceUnavailable; readonly when: "Every attempt of the batch request failed on ClinicalTrials.gov’s side — HTTP 500, 502, or 503, a dropped connection or one the network gave up opening, or a 200 body that is not the JSON the route serves (an HTML page, unparseable text, the wrong shape) — or it answered the batch with another 5xx, such as 505, or the connection was refused or its host name did not resolve, none of which is retried."; readonly recovery: "Retry the same call unchanged after a few minutes — the arguments were not at fault. If it keeps failing, ClinicalTrials.gov is down; tell the user rather than rewording the query."; readonly retryable: true; readonly thrownBy: "service"; }, { readonly reason: "upstream_rejected"; readonly code: JsonRpcErrorCode.ServiceUnavailable; readonly when: "ClinicalTrials.gov refused the batch request with a status its API does not use for a bad query — HTTP 501, a 3xx, or a 4xx such as 401, 403, or 410 — or answered it with an HTML error page in place of its own 404."; readonly recovery: "Do not retry the same call right away or reword it — ClinicalTrials.gov refused it for a reason unrelated to the arguments, and it will refuse again. Tell the user the registry is not serving this request, and try again later."; readonly retryable: false; readonly thrownBy: "service"; }], undefined>; //# sourceMappingURL=get-study-results.tool.d.ts.map