@cyanheads/brapi-mcp-server 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/CLAUDE.md +391 -0
  2. package/Dockerfile +99 -0
  3. package/LICENSE +201 -0
  4. package/README.md +590 -0
  5. package/changelog/0.1.x/0.1.0.md +19 -0
  6. package/changelog/0.1.x/0.1.1.md +27 -0
  7. package/changelog/0.1.x/0.1.2.md +22 -0
  8. package/changelog/0.2.x/0.2.0.md +35 -0
  9. package/changelog/0.2.x/0.2.1.md +36 -0
  10. package/changelog/0.3.x/0.3.0.md +38 -0
  11. package/changelog/0.3.x/0.3.1.md +40 -0
  12. package/changelog/0.3.x/0.3.2.md +29 -0
  13. package/changelog/0.3.x/0.3.3.md +19 -0
  14. package/changelog/0.3.x/0.3.4.md +33 -0
  15. package/changelog/0.3.x/0.3.5.md +24 -0
  16. package/changelog/template.md +51 -0
  17. package/dist/config/alias-credentials.d.ts +82 -0
  18. package/dist/config/alias-credentials.d.ts.map +1 -0
  19. package/dist/config/alias-credentials.js +159 -0
  20. package/dist/config/alias-credentials.js.map +1 -0
  21. package/dist/config/server-config.d.ts +39 -0
  22. package/dist/config/server-config.d.ts.map +1 -0
  23. package/dist/config/server-config.js +128 -0
  24. package/dist/config/server-config.js.map +1 -0
  25. package/dist/index.d.ts +10 -0
  26. package/dist/index.d.ts.map +1 -0
  27. package/dist/index.js +85 -0
  28. package/dist/index.js.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/brapi-eda-study.prompt.d.ts +14 -0
  30. package/dist/mcp-server/prompts/definitions/brapi-eda-study.prompt.d.ts.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/brapi-eda-study.prompt.js +75 -0
  32. package/dist/mcp-server/prompts/definitions/brapi-eda-study.prompt.js.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.d.ts +16 -0
  34. package/dist/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.d.ts.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.js +109 -0
  36. package/dist/mcp-server/prompts/definitions/brapi-meta-analysis.prompt.js.map +1 -0
  37. package/dist/mcp-server/resources/definitions/brapi-calls.resource.d.ts +11 -0
  38. package/dist/mcp-server/resources/definitions/brapi-calls.resource.d.ts.map +1 -0
  39. package/dist/mcp-server/resources/definitions/brapi-calls.resource.js +46 -0
  40. package/dist/mcp-server/resources/definitions/brapi-calls.resource.js.map +1 -0
  41. package/dist/mcp-server/resources/definitions/brapi-dataset.resource.d.ts +13 -0
  42. package/dist/mcp-server/resources/definitions/brapi-dataset.resource.d.ts.map +1 -0
  43. package/dist/mcp-server/resources/definitions/brapi-dataset.resource.js +26 -0
  44. package/dist/mcp-server/resources/definitions/brapi-dataset.resource.js.map +1 -0
  45. package/dist/mcp-server/resources/definitions/brapi-filters.resource.d.ts +19 -0
  46. package/dist/mcp-server/resources/definitions/brapi-filters.resource.d.ts.map +1 -0
  47. package/dist/mcp-server/resources/definitions/brapi-filters.resource.js +45 -0
  48. package/dist/mcp-server/resources/definitions/brapi-filters.resource.js.map +1 -0
  49. package/dist/mcp-server/resources/definitions/brapi-germplasm.resource.d.ts +18 -0
  50. package/dist/mcp-server/resources/definitions/brapi-germplasm.resource.d.ts.map +1 -0
  51. package/dist/mcp-server/resources/definitions/brapi-germplasm.resource.js +34 -0
  52. package/dist/mcp-server/resources/definitions/brapi-germplasm.resource.js.map +1 -0
  53. package/dist/mcp-server/resources/definitions/brapi-server-info.resource.d.ts +11 -0
  54. package/dist/mcp-server/resources/definitions/brapi-server-info.resource.d.ts.map +1 -0
  55. package/dist/mcp-server/resources/definitions/brapi-server-info.resource.js +28 -0
  56. package/dist/mcp-server/resources/definitions/brapi-server-info.resource.js.map +1 -0
  57. package/dist/mcp-server/resources/definitions/brapi-study.resource.d.ts +18 -0
  58. package/dist/mcp-server/resources/definitions/brapi-study.resource.d.ts.map +1 -0
  59. package/dist/mcp-server/resources/definitions/brapi-study.resource.js +34 -0
  60. package/dist/mcp-server/resources/definitions/brapi-study.resource.js.map +1 -0
  61. package/dist/mcp-server/tools/definitions/brapi-connect.tool.d.ts +82 -0
  62. package/dist/mcp-server/tools/definitions/brapi-connect.tool.d.ts.map +1 -0
  63. package/dist/mcp-server/tools/definitions/brapi-connect.tool.js +106 -0
  64. package/dist/mcp-server/tools/definitions/brapi-connect.tool.js.map +1 -0
  65. package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.d.ts +41 -0
  66. package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.d.ts.map +1 -0
  67. package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.js +88 -0
  68. package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.js.map +1 -0
  69. package/dist/mcp-server/tools/definitions/brapi-find-genotype-calls.tool.d.ts +74 -0
  70. package/dist/mcp-server/tools/definitions/brapi-find-genotype-calls.tool.d.ts.map +1 -0
  71. package/dist/mcp-server/tools/definitions/brapi-find-genotype-calls.tool.js +386 -0
  72. package/dist/mcp-server/tools/definitions/brapi-find-genotype-calls.tool.js.map +1 -0
  73. package/dist/mcp-server/tools/definitions/brapi-find-germplasm.tool.d.ts +72 -0
  74. package/dist/mcp-server/tools/definitions/brapi-find-germplasm.tool.d.ts.map +1 -0
  75. package/dist/mcp-server/tools/definitions/brapi-find-germplasm.tool.js +290 -0
  76. package/dist/mcp-server/tools/definitions/brapi-find-germplasm.tool.js.map +1 -0
  77. package/dist/mcp-server/tools/definitions/brapi-find-images.tool.d.ts +65 -0
  78. package/dist/mcp-server/tools/definitions/brapi-find-images.tool.d.ts.map +1 -0
  79. package/dist/mcp-server/tools/definitions/brapi-find-images.tool.js +243 -0
  80. package/dist/mcp-server/tools/definitions/brapi-find-images.tool.js.map +1 -0
  81. package/dist/mcp-server/tools/definitions/brapi-find-locations.tool.d.ts +63 -0
  82. package/dist/mcp-server/tools/definitions/brapi-find-locations.tool.d.ts.map +1 -0
  83. package/dist/mcp-server/tools/definitions/brapi-find-locations.tool.js +278 -0
  84. package/dist/mcp-server/tools/definitions/brapi-find-locations.tool.js.map +1 -0
  85. package/dist/mcp-server/tools/definitions/brapi-find-observations.tool.d.ts +74 -0
  86. package/dist/mcp-server/tools/definitions/brapi-find-observations.tool.d.ts.map +1 -0
  87. package/dist/mcp-server/tools/definitions/brapi-find-observations.tool.js +288 -0
  88. package/dist/mcp-server/tools/definitions/brapi-find-observations.tool.js.map +1 -0
  89. package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.d.ts +69 -0
  90. package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.d.ts.map +1 -0
  91. package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.js +243 -0
  92. package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.js.map +1 -0
  93. package/dist/mcp-server/tools/definitions/brapi-find-variables.tool.d.ts +86 -0
  94. package/dist/mcp-server/tools/definitions/brapi-find-variables.tool.d.ts.map +1 -0
  95. package/dist/mcp-server/tools/definitions/brapi-find-variables.tool.js +337 -0
  96. package/dist/mcp-server/tools/definitions/brapi-find-variables.tool.js.map +1 -0
  97. package/dist/mcp-server/tools/definitions/brapi-find-variants.tool.d.ts +59 -0
  98. package/dist/mcp-server/tools/definitions/brapi-find-variants.tool.d.ts.map +1 -0
  99. package/dist/mcp-server/tools/definitions/brapi-find-variants.tool.js +248 -0
  100. package/dist/mcp-server/tools/definitions/brapi-find-variants.tool.js.map +1 -0
  101. package/dist/mcp-server/tools/definitions/brapi-get-germplasm.tool.d.ts +59 -0
  102. package/dist/mcp-server/tools/definitions/brapi-get-germplasm.tool.d.ts.map +1 -0
  103. package/dist/mcp-server/tools/definitions/brapi-get-germplasm.tool.js +306 -0
  104. package/dist/mcp-server/tools/definitions/brapi-get-germplasm.tool.js.map +1 -0
  105. package/dist/mcp-server/tools/definitions/brapi-get-image.tool.d.ts +57 -0
  106. package/dist/mcp-server/tools/definitions/brapi-get-image.tool.d.ts.map +1 -0
  107. package/dist/mcp-server/tools/definitions/brapi-get-image.tool.js +291 -0
  108. package/dist/mcp-server/tools/definitions/brapi-get-image.tool.js.map +1 -0
  109. package/dist/mcp-server/tools/definitions/brapi-get-study.tool.d.ts +75 -0
  110. package/dist/mcp-server/tools/definitions/brapi-get-study.tool.d.ts.map +1 -0
  111. package/dist/mcp-server/tools/definitions/brapi-get-study.tool.js +323 -0
  112. package/dist/mcp-server/tools/definitions/brapi-get-study.tool.js.map +1 -0
  113. package/dist/mcp-server/tools/definitions/brapi-manage-dataset.tool.d.ts +87 -0
  114. package/dist/mcp-server/tools/definitions/brapi-manage-dataset.tool.d.ts.map +1 -0
  115. package/dist/mcp-server/tools/definitions/brapi-manage-dataset.tool.js +296 -0
  116. package/dist/mcp-server/tools/definitions/brapi-manage-dataset.tool.js.map +1 -0
  117. package/dist/mcp-server/tools/definitions/brapi-raw-get.tool.d.ts +35 -0
  118. package/dist/mcp-server/tools/definitions/brapi-raw-get.tool.d.ts.map +1 -0
  119. package/dist/mcp-server/tools/definitions/brapi-raw-get.tool.js +148 -0
  120. package/dist/mcp-server/tools/definitions/brapi-raw-get.tool.js.map +1 -0
  121. package/dist/mcp-server/tools/definitions/brapi-raw-search.tool.d.ts +33 -0
  122. package/dist/mcp-server/tools/definitions/brapi-raw-search.tool.d.ts.map +1 -0
  123. package/dist/mcp-server/tools/definitions/brapi-raw-search.tool.js +126 -0
  124. package/dist/mcp-server/tools/definitions/brapi-raw-search.tool.js.map +1 -0
  125. package/dist/mcp-server/tools/definitions/brapi-server-info.tool.d.ts +51 -0
  126. package/dist/mcp-server/tools/definitions/brapi-server-info.tool.d.ts.map +1 -0
  127. package/dist/mcp-server/tools/definitions/brapi-server-info.tool.js +41 -0
  128. package/dist/mcp-server/tools/definitions/brapi-server-info.tool.js.map +1 -0
  129. package/dist/mcp-server/tools/definitions/brapi-submit-observations.tool.d.ts +117 -0
  130. package/dist/mcp-server/tools/definitions/brapi-submit-observations.tool.d.ts.map +1 -0
  131. package/dist/mcp-server/tools/definitions/brapi-submit-observations.tool.js +574 -0
  132. package/dist/mcp-server/tools/definitions/brapi-submit-observations.tool.js.map +1 -0
  133. package/dist/mcp-server/tools/definitions/brapi-walk-pedigree.tool.d.ts +52 -0
  134. package/dist/mcp-server/tools/definitions/brapi-walk-pedigree.tool.d.ts.map +1 -0
  135. package/dist/mcp-server/tools/definitions/brapi-walk-pedigree.tool.js +420 -0
  136. package/dist/mcp-server/tools/definitions/brapi-walk-pedigree.tool.js.map +1 -0
  137. package/dist/mcp-server/tools/shared/connect-auth-schema.d.ts +29 -0
  138. package/dist/mcp-server/tools/shared/connect-auth-schema.d.ts.map +1 -0
  139. package/dist/mcp-server/tools/shared/connect-auth-schema.js +55 -0
  140. package/dist/mcp-server/tools/shared/connect-auth-schema.js.map +1 -0
  141. package/dist/mcp-server/tools/shared/find-helpers.d.ts +143 -0
  142. package/dist/mcp-server/tools/shared/find-helpers.d.ts.map +1 -0
  143. package/dist/mcp-server/tools/shared/find-helpers.js +319 -0
  144. package/dist/mcp-server/tools/shared/find-helpers.js.map +1 -0
  145. package/dist/mcp-server/tools/shared/orientation-envelope.d.ts +97 -0
  146. package/dist/mcp-server/tools/shared/orientation-envelope.d.ts.map +1 -0
  147. package/dist/mcp-server/tools/shared/orientation-envelope.js +254 -0
  148. package/dist/mcp-server/tools/shared/orientation-envelope.js.map +1 -0
  149. package/dist/mcp-server/tools/shared/raw-routing-hints.d.ts +10 -0
  150. package/dist/mcp-server/tools/shared/raw-routing-hints.d.ts.map +1 -0
  151. package/dist/mcp-server/tools/shared/raw-routing-hints.js +46 -0
  152. package/dist/mcp-server/tools/shared/raw-routing-hints.js.map +1 -0
  153. package/dist/services/brapi-client/brapi-client.d.ts +76 -0
  154. package/dist/services/brapi-client/brapi-client.d.ts.map +1 -0
  155. package/dist/services/brapi-client/brapi-client.js +320 -0
  156. package/dist/services/brapi-client/brapi-client.js.map +1 -0
  157. package/dist/services/brapi-client/index.d.ts +9 -0
  158. package/dist/services/brapi-client/index.d.ts.map +1 -0
  159. package/dist/services/brapi-client/index.js +7 -0
  160. package/dist/services/brapi-client/index.js.map +1 -0
  161. package/dist/services/brapi-client/types.d.ts +82 -0
  162. package/dist/services/brapi-client/types.d.ts.map +1 -0
  163. package/dist/services/brapi-client/types.js +8 -0
  164. package/dist/services/brapi-client/types.js.map +1 -0
  165. package/dist/services/brapi-filters/catalog.d.ts +14 -0
  166. package/dist/services/brapi-filters/catalog.d.ts.map +1 -0
  167. package/dist/services/brapi-filters/catalog.js +490 -0
  168. package/dist/services/brapi-filters/catalog.js.map +1 -0
  169. package/dist/services/brapi-filters/index.d.ts +8 -0
  170. package/dist/services/brapi-filters/index.d.ts.map +1 -0
  171. package/dist/services/brapi-filters/index.js +7 -0
  172. package/dist/services/brapi-filters/index.js.map +1 -0
  173. package/dist/services/brapi-filters/types.d.ts +23 -0
  174. package/dist/services/brapi-filters/types.d.ts.map +1 -0
  175. package/dist/services/brapi-filters/types.js +9 -0
  176. package/dist/services/brapi-filters/types.js.map +1 -0
  177. package/dist/services/capability-registry/capability-registry.d.ts +51 -0
  178. package/dist/services/capability-registry/capability-registry.d.ts.map +1 -0
  179. package/dist/services/capability-registry/capability-registry.js +234 -0
  180. package/dist/services/capability-registry/capability-registry.js.map +1 -0
  181. package/dist/services/capability-registry/index.d.ts +9 -0
  182. package/dist/services/capability-registry/index.d.ts.map +1 -0
  183. package/dist/services/capability-registry/index.js +7 -0
  184. package/dist/services/capability-registry/index.js.map +1 -0
  185. package/dist/services/capability-registry/types.d.ts +67 -0
  186. package/dist/services/capability-registry/types.d.ts.map +1 -0
  187. package/dist/services/capability-registry/types.js +9 -0
  188. package/dist/services/capability-registry/types.js.map +1 -0
  189. package/dist/services/dataset-store/dataset-store.d.ts +35 -0
  190. package/dist/services/dataset-store/dataset-store.d.ts.map +1 -0
  191. package/dist/services/dataset-store/dataset-store.js +190 -0
  192. package/dist/services/dataset-store/dataset-store.js.map +1 -0
  193. package/dist/services/dataset-store/index.d.ts +8 -0
  194. package/dist/services/dataset-store/index.d.ts.map +1 -0
  195. package/dist/services/dataset-store/index.js +7 -0
  196. package/dist/services/dataset-store/index.js.map +1 -0
  197. package/dist/services/dataset-store/types.d.ts +65 -0
  198. package/dist/services/dataset-store/types.d.ts.map +1 -0
  199. package/dist/services/dataset-store/types.js +8 -0
  200. package/dist/services/dataset-store/types.js.map +1 -0
  201. package/dist/services/ontology-resolver/index.d.ts +8 -0
  202. package/dist/services/ontology-resolver/index.d.ts.map +1 -0
  203. package/dist/services/ontology-resolver/index.js +7 -0
  204. package/dist/services/ontology-resolver/index.js.map +1 -0
  205. package/dist/services/ontology-resolver/ontology-resolver.d.ts +49 -0
  206. package/dist/services/ontology-resolver/ontology-resolver.d.ts.map +1 -0
  207. package/dist/services/ontology-resolver/ontology-resolver.js +99 -0
  208. package/dist/services/ontology-resolver/ontology-resolver.js.map +1 -0
  209. package/dist/services/ontology-resolver/types.d.ts +38 -0
  210. package/dist/services/ontology-resolver/types.d.ts.map +1 -0
  211. package/dist/services/ontology-resolver/types.js +8 -0
  212. package/dist/services/ontology-resolver/types.js.map +1 -0
  213. package/dist/services/reference-data-cache/index.d.ts +9 -0
  214. package/dist/services/reference-data-cache/index.d.ts.map +1 -0
  215. package/dist/services/reference-data-cache/index.js +7 -0
  216. package/dist/services/reference-data-cache/index.js.map +1 -0
  217. package/dist/services/reference-data-cache/reference-data-cache.d.ts +31 -0
  218. package/dist/services/reference-data-cache/reference-data-cache.d.ts.map +1 -0
  219. package/dist/services/reference-data-cache/reference-data-cache.js +131 -0
  220. package/dist/services/reference-data-cache/reference-data-cache.js.map +1 -0
  221. package/dist/services/reference-data-cache/types.d.ts +42 -0
  222. package/dist/services/reference-data-cache/types.d.ts.map +1 -0
  223. package/dist/services/reference-data-cache/types.js +9 -0
  224. package/dist/services/reference-data-cache/types.js.map +1 -0
  225. package/dist/services/server-registry/index.d.ts +9 -0
  226. package/dist/services/server-registry/index.d.ts.map +1 -0
  227. package/dist/services/server-registry/index.js +7 -0
  228. package/dist/services/server-registry/index.js.map +1 -0
  229. package/dist/services/server-registry/server-registry.d.ts +57 -0
  230. package/dist/services/server-registry/server-registry.d.ts.map +1 -0
  231. package/dist/services/server-registry/server-registry.js +210 -0
  232. package/dist/services/server-registry/server-registry.js.map +1 -0
  233. package/dist/services/server-registry/types.d.ts +43 -0
  234. package/dist/services/server-registry/types.d.ts.map +1 -0
  235. package/dist/services/server-registry/types.js +10 -0
  236. package/dist/services/server-registry/types.js.map +1 -0
  237. package/package.json +86 -0
  238. package/server.json +99 -0
@@ -0,0 +1,323 @@
1
+ /**
2
+ * @fileoverview `brapi_get_study` — fetch a single study by DbId, resolve
3
+ * program/trial/location FKs via ReferenceDataCache, and attach cheap
4
+ * `pageSize=0` counts (observations, observation units, variables) as
5
+ * response companions so the agent can decide where to drill next.
6
+ *
7
+ * @module mcp-server/tools/definitions/brapi-get-study.tool
8
+ */
9
+ import { tool, z } from '@cyanheads/mcp-ts-core';
10
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
+ import { getBrapiClient } from '../../../services/brapi-client/index.js';
12
+ import { getCapabilityRegistry } from '../../../services/capability-registry/index.js';
13
+ import { getReferenceDataCache } from '../../../services/reference-data-cache/index.js';
14
+ import { DEFAULT_ALIAS, getServerRegistry } from '../../../services/server-registry/index.js';
15
+ import { AliasInput, buildRequestOptions, isUpstreamNotFound } from '../shared/find-helpers.js';
16
+ const StudySchema = z
17
+ .object({
18
+ studyDbId: z.string().describe('Server-side identifier for the study.'),
19
+ studyName: z.string().nullish().describe('Display name.'),
20
+ studyType: z.string().nullish().describe('E.g. "Yield Trial", "Phenotyping".'),
21
+ studyDescription: z.string().nullish().describe('Free-form description.'),
22
+ programDbId: z.string().nullish().describe('FK to the owning program.'),
23
+ programName: z.string().nullish().describe('Display name of the owning program.'),
24
+ trialDbId: z.string().nullish().describe('FK to the owning trial.'),
25
+ trialName: z.string().nullish().describe('Display name of the owning trial.'),
26
+ locationDbId: z.string().nullish().describe('FK to the study site.'),
27
+ locationName: z.string().nullish().describe('Display name of the study site.'),
28
+ commonCropName: z.string().nullish().describe('Common crop name (e.g. "Maize", "Wheat").'),
29
+ seasons: z
30
+ .array(z.string().describe('Season identifier — typically a year like "2022".'))
31
+ .nullish()
32
+ .describe('Season identifiers this study spans.'),
33
+ active: z.boolean().nullish().describe('True while the study is open for data capture.'),
34
+ startDate: z.string().nullish().describe('ISO 8601 start date.'),
35
+ endDate: z.string().nullish().describe('ISO 8601 end date.'),
36
+ studyCode: z.string().nullish().describe('Short code or alias for the study.'),
37
+ studyPUI: z.string().nullish().describe('Persistent unique identifier (URI).'),
38
+ })
39
+ .passthrough();
40
+ const ProgramSchema = z
41
+ .object({
42
+ programDbId: z.string().describe('Server-side identifier for the program.'),
43
+ programName: z.string().nullish().describe('Display name.'),
44
+ commonCropName: z.string().nullish().describe('Common crop name this program targets.'),
45
+ abbreviation: z.string().nullish().describe('Short abbreviation.'),
46
+ leadPersonName: z.string().nullish().describe('Name of the program lead.'),
47
+ documentationURL: z.string().nullish().describe('URL pointing at program documentation.'),
48
+ })
49
+ .passthrough();
50
+ const TrialSchema = z
51
+ .object({
52
+ trialDbId: z.string().describe('Server-side identifier for the trial.'),
53
+ trialName: z.string().nullish().describe('Display name.'),
54
+ programDbId: z.string().nullish().describe('FK to the owning program.'),
55
+ programName: z.string().nullish().describe('Display name of the owning program.'),
56
+ commonCropName: z.string().nullish().describe('Common crop name.'),
57
+ startDate: z.string().nullish().describe('ISO 8601 start date.'),
58
+ endDate: z.string().nullish().describe('ISO 8601 end date.'),
59
+ active: z.boolean().nullish().describe('True while the trial is ongoing.'),
60
+ trialDescription: z.string().nullish().describe('Free-form description.'),
61
+ })
62
+ .passthrough();
63
+ const LocationSchema = z
64
+ .object({
65
+ locationDbId: z.string().describe('Server-side identifier for the location.'),
66
+ locationName: z.string().nullish().describe('Display name.'),
67
+ abbreviation: z.string().nullish().describe('Short abbreviation.'),
68
+ countryCode: z.string().nullish().describe('ISO 3166-1 alpha-3 country code.'),
69
+ countryName: z.string().nullish().describe('Display name of the country.'),
70
+ locationType: z
71
+ .string()
72
+ .nullish()
73
+ .describe('Type of location (e.g. "Research Station", "Field").'),
74
+ latitude: z.number().nullish().describe('WGS84 latitude in decimal degrees.'),
75
+ longitude: z.number().nullish().describe('WGS84 longitude in decimal degrees.'),
76
+ altitude: z.number().nullish().describe('Altitude in meters above sea level.'),
77
+ })
78
+ .passthrough();
79
+ const OutputSchema = z.object({
80
+ alias: z.string().describe('Alias of the registered BrAPI connection the call used.'),
81
+ study: StudySchema.describe('Canonical study record as returned by `/studies/{id}`.'),
82
+ program: ProgramSchema.optional().describe('Resolved program record (when the study has a programDbId and the FK lookup succeeded).'),
83
+ trial: TrialSchema.optional().describe('Resolved trial record (when the study has a trialDbId and the FK lookup succeeded).'),
84
+ location: LocationSchema.optional().describe('Resolved location record (when the study has a locationDbId and the FK lookup succeeded).'),
85
+ observationCount: z
86
+ .number()
87
+ .int()
88
+ .nonnegative()
89
+ .optional()
90
+ .describe('Total observations recorded against this study.'),
91
+ observationUnitCount: z
92
+ .number()
93
+ .int()
94
+ .nonnegative()
95
+ .optional()
96
+ .describe('Total observation units (plots, plants, samples) in this study.'),
97
+ variableCount: z
98
+ .number()
99
+ .int()
100
+ .nonnegative()
101
+ .optional()
102
+ .describe('Total observation variables (traits) measured in this study.'),
103
+ warnings: z.array(z.string()).describe('Advisory messages — failed FK lookups, missing counts.'),
104
+ });
105
+ export const brapiGetStudy = tool('brapi_get_study', {
106
+ description: 'Fetch a single study by DbId with program, trial, and location fully resolved. Response includes cheap observation/observation-unit/variable counts as drill-down signals.',
107
+ annotations: { readOnlyHint: true, idempotentHint: true },
108
+ errors: [
109
+ {
110
+ reason: 'study_not_found',
111
+ code: JsonRpcErrorCode.NotFound,
112
+ when: 'Upstream returned no study record for the requested DbId',
113
+ recovery: 'Verify the studyDbId on the target server, or run brapi_find_studies to discover valid IDs.',
114
+ },
115
+ ],
116
+ input: z.object({
117
+ studyDbId: z.string().min(1).describe('Study identifier.'),
118
+ alias: AliasInput,
119
+ }),
120
+ output: OutputSchema,
121
+ async handler(input, ctx) {
122
+ const registry = getServerRegistry();
123
+ const capabilities = getCapabilityRegistry();
124
+ const client = getBrapiClient();
125
+ const referenceData = getReferenceDataCache();
126
+ const connection = await registry.get(ctx, input.alias ?? DEFAULT_ALIAS);
127
+ const capabilityLookup = {};
128
+ if (connection.resolvedAuth)
129
+ capabilityLookup.auth = connection.resolvedAuth;
130
+ await capabilities.ensure(connection.baseUrl, { service: 'studies', method: 'GET' }, ctx, capabilityLookup);
131
+ const warnings = [];
132
+ const referenceLookup = {};
133
+ if (connection.resolvedAuth)
134
+ referenceLookup.auth = connection.resolvedAuth;
135
+ let studyEnv;
136
+ try {
137
+ studyEnv = await client.get(connection.baseUrl, `/studies/${encodeURIComponent(input.studyDbId)}`, ctx, buildRequestOptions(connection));
138
+ }
139
+ catch (err) {
140
+ if (isUpstreamNotFound(err)) {
141
+ throw ctx.fail('study_not_found', `Study '${input.studyDbId}' not found on ${connection.baseUrl}.`, {
142
+ studyDbId: input.studyDbId,
143
+ baseUrl: connection.baseUrl,
144
+ ...ctx.recoveryFor('study_not_found'),
145
+ });
146
+ }
147
+ throw err;
148
+ }
149
+ const study = studyEnv.result;
150
+ if (!study || typeof study !== 'object' || !study.studyDbId) {
151
+ throw ctx.fail('study_not_found', `Study '${input.studyDbId}' not found on ${connection.baseUrl}.`, {
152
+ studyDbId: input.studyDbId,
153
+ baseUrl: connection.baseUrl,
154
+ ...ctx.recoveryFor('study_not_found'),
155
+ });
156
+ }
157
+ const profile = await capabilities.profile(connection.baseUrl, ctx, capabilityLookup);
158
+ const supportsObservations = profile.supported.observations?.methods?.includes('GET') ?? false;
159
+ const supportsObservationUnits = profile.supported.observationunits?.methods?.includes('GET') ?? false;
160
+ const supportsVariables = profile.supported.variables?.methods?.includes('GET') ?? false;
161
+ const programDbId = asString(study.programDbId);
162
+ const trialDbId = asString(study.trialDbId);
163
+ const locationDbId = asString(study.locationDbId);
164
+ const [programs, trials, locations, obsCount, obsUnitCount, variableCount] = await Promise.all([
165
+ programDbId
166
+ ? referenceData
167
+ .getPrograms(connection.baseUrl, [programDbId], ctx, referenceLookup)
168
+ .catch((err) => recordWarning(warnings, 'program FK lookup failed', err))
169
+ : Promise.resolve(undefined),
170
+ trialDbId
171
+ ? referenceData
172
+ .getTrials(connection.baseUrl, [trialDbId], ctx, referenceLookup)
173
+ .catch((err) => recordWarning(warnings, 'trial FK lookup failed', err))
174
+ : Promise.resolve(undefined),
175
+ locationDbId
176
+ ? referenceData
177
+ .getLocations(connection.baseUrl, [locationDbId], ctx, referenceLookup)
178
+ .catch((err) => recordWarning(warnings, 'location FK lookup failed', err))
179
+ : Promise.resolve(undefined),
180
+ supportsObservations
181
+ ? fetchTotalCount(client, connection.baseUrl, '/observations', ctx, buildRequestOptions(connection, {
182
+ studyDbIds: [input.studyDbId],
183
+ pageSize: 1,
184
+ })).catch((err) => recordWarning(warnings, 'observation count probe failed', err))
185
+ : Promise.resolve(undefined),
186
+ supportsObservationUnits
187
+ ? fetchTotalCount(client, connection.baseUrl, '/observationunits', ctx, buildRequestOptions(connection, {
188
+ studyDbIds: [input.studyDbId],
189
+ pageSize: 1,
190
+ })).catch((err) => recordWarning(warnings, 'observation-unit count probe failed', err))
191
+ : Promise.resolve(undefined),
192
+ supportsVariables
193
+ ? fetchTotalCount(client, connection.baseUrl, '/variables', ctx, buildRequestOptions(connection, {
194
+ studyDbId: input.studyDbId,
195
+ pageSize: 1,
196
+ })).catch((err) => recordWarning(warnings, 'variable count probe failed', err))
197
+ : Promise.resolve(undefined),
198
+ ]);
199
+ const result = {
200
+ alias: connection.alias,
201
+ study: study,
202
+ warnings,
203
+ };
204
+ if (programDbId && programs instanceof Map) {
205
+ const program = programs.get(programDbId);
206
+ if (program)
207
+ result.program = program;
208
+ }
209
+ if (trialDbId && trials instanceof Map) {
210
+ const trial = trials.get(trialDbId);
211
+ if (trial)
212
+ result.trial = trial;
213
+ }
214
+ if (locationDbId && locations instanceof Map) {
215
+ const location = locations.get(locationDbId);
216
+ if (location)
217
+ result.location = location;
218
+ }
219
+ if (typeof obsCount === 'number')
220
+ result.observationCount = obsCount;
221
+ if (typeof obsUnitCount === 'number')
222
+ result.observationUnitCount = obsUnitCount;
223
+ if (typeof variableCount === 'number')
224
+ result.variableCount = variableCount;
225
+ return result;
226
+ },
227
+ format: (result) => {
228
+ const lines = [];
229
+ const study = result.study;
230
+ lines.push(`# ${study.studyName ?? study.studyDbId}`);
231
+ lines.push('');
232
+ lines.push(`- **studyDbId:** \`${study.studyDbId}\``);
233
+ if (study.studyName)
234
+ lines.push(`- **studyName:** ${study.studyName}`);
235
+ if (study.studyType)
236
+ lines.push(`- **studyType:** ${study.studyType}`);
237
+ if (study.studyDescription)
238
+ lines.push(`- **studyDescription:** ${study.studyDescription}`);
239
+ if (study.programDbId)
240
+ lines.push(`- **programDbId:** ${study.programDbId}`);
241
+ if (study.programName)
242
+ lines.push(`- **programName:** ${study.programName}`);
243
+ if (study.trialDbId)
244
+ lines.push(`- **trialDbId:** ${study.trialDbId}`);
245
+ if (study.trialName)
246
+ lines.push(`- **trialName:** ${study.trialName}`);
247
+ if (study.locationDbId)
248
+ lines.push(`- **locationDbId:** ${study.locationDbId}`);
249
+ if (study.locationName)
250
+ lines.push(`- **locationName:** ${study.locationName}`);
251
+ if (study.commonCropName)
252
+ lines.push(`- **commonCropName:** ${study.commonCropName}`);
253
+ if (study.seasons?.length)
254
+ lines.push(`- **seasons:** ${study.seasons.join(', ')}`);
255
+ if (study.active != null)
256
+ lines.push(`- **active:** ${study.active}`);
257
+ if (study.startDate)
258
+ lines.push(`- **startDate:** ${study.startDate}`);
259
+ if (study.endDate)
260
+ lines.push(`- **endDate:** ${study.endDate}`);
261
+ if (study.studyCode)
262
+ lines.push(`- **studyCode:** ${study.studyCode}`);
263
+ if (study.studyPUI)
264
+ lines.push(`- **studyPUI:** ${study.studyPUI}`);
265
+ lines.push(`- **alias:** ${result.alias}`);
266
+ if (result.program) {
267
+ lines.push('');
268
+ lines.push('## Program');
269
+ renderKeyValues(lines, result.program);
270
+ }
271
+ if (result.trial) {
272
+ lines.push('');
273
+ lines.push('## Trial');
274
+ renderKeyValues(lines, result.trial);
275
+ }
276
+ if (result.location) {
277
+ lines.push('');
278
+ lines.push('## Location');
279
+ renderKeyValues(lines, result.location);
280
+ }
281
+ lines.push('');
282
+ lines.push('## Drill-down signals');
283
+ lines.push(`- observationCount: ${result.observationCount ?? '—'}`);
284
+ lines.push(`- observationUnitCount: ${result.observationUnitCount ?? '—'}`);
285
+ lines.push(`- variableCount: ${result.variableCount ?? '—'}`);
286
+ if (result.warnings.length > 0) {
287
+ lines.push('');
288
+ lines.push('## Warnings');
289
+ for (const w of result.warnings)
290
+ lines.push(`- ${w}`);
291
+ }
292
+ return [{ type: 'text', text: lines.join('\n') }];
293
+ },
294
+ });
295
+ function asString(value) {
296
+ return typeof value === 'string' && value.length > 0 ? value : undefined;
297
+ }
298
+ function recordWarning(warnings, label, err) {
299
+ warnings.push(`${label}: ${err instanceof Error ? err.message : String(err)}`);
300
+ return;
301
+ }
302
+ async function fetchTotalCount(client, baseUrl, path, ctx, options) {
303
+ const env = await client.get(baseUrl, path, ctx, options);
304
+ const total = env.metadata?.pagination?.totalCount;
305
+ return typeof total === 'number' ? total : undefined;
306
+ }
307
+ function renderKeyValues(lines, record) {
308
+ for (const [key, value] of Object.entries(record)) {
309
+ if (value === undefined || value === null)
310
+ continue;
311
+ if (Array.isArray(value)) {
312
+ if (value.length === 0)
313
+ continue;
314
+ lines.push(`- **${key}:** ${value.join(', ')}`);
315
+ }
316
+ else if (typeof value === 'object') {
317
+ }
318
+ else {
319
+ lines.push(`- **${key}:** ${value}`);
320
+ }
321
+ }
322
+ }
323
+ //# sourceMappingURL=brapi-get-study.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"brapi-get-study.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-get-study.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * @fileoverview `brapi_manage_dataset` — consolidated lifecycle tool for
3
+ * datasets created by `find_*` spillovers. Four modes discriminated by
4
+ * `mode`: list (enumerate with provenance), summary (metadata only), load
5
+ * (paged rows with optional column projection), delete (drop metadata +
6
+ * payload). Export (CSV/Parquet) is deferred until storage backends for the
7
+ * write path are wired up.
8
+ *
9
+ * @module mcp-server/tools/definitions/brapi-manage-dataset.tool
10
+ */
11
+ import { z } from '@cyanheads/mcp-ts-core';
12
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
13
+ export declare const brapiManageDataset: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
14
+ mode: z.ZodEnum<{
15
+ delete: "delete";
16
+ list: "list";
17
+ summary: "summary";
18
+ load: "load";
19
+ }>;
20
+ datasetId: z.ZodOptional<z.ZodString>;
21
+ cursor: z.ZodOptional<z.ZodString>;
22
+ limit: z.ZodOptional<z.ZodNumber>;
23
+ page: z.ZodOptional<z.ZodNumber>;
24
+ pageSize: z.ZodOptional<z.ZodNumber>;
25
+ columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
26
+ }, z.core.$strip>, z.ZodObject<{
27
+ result: z.ZodDiscriminatedUnion<[z.ZodObject<{
28
+ mode: z.ZodLiteral<"list">;
29
+ datasets: z.ZodArray<z.ZodObject<{
30
+ datasetId: z.ZodString;
31
+ source: z.ZodString;
32
+ baseUrl: z.ZodString;
33
+ query: z.ZodUnknown;
34
+ rowCount: z.ZodNumber;
35
+ columns: z.ZodArray<z.ZodString>;
36
+ sizeBytes: z.ZodNumber;
37
+ createdAt: z.ZodString;
38
+ expiresAt: z.ZodString;
39
+ truncated: z.ZodOptional<z.ZodBoolean>;
40
+ maxRows: z.ZodOptional<z.ZodNumber>;
41
+ }, z.core.$strip>>;
42
+ cursor: z.ZodOptional<z.ZodString>;
43
+ }, z.core.$strip>, z.ZodObject<{
44
+ mode: z.ZodLiteral<"summary">;
45
+ dataset: z.ZodObject<{
46
+ datasetId: z.ZodString;
47
+ source: z.ZodString;
48
+ baseUrl: z.ZodString;
49
+ query: z.ZodUnknown;
50
+ rowCount: z.ZodNumber;
51
+ columns: z.ZodArray<z.ZodString>;
52
+ sizeBytes: z.ZodNumber;
53
+ createdAt: z.ZodString;
54
+ expiresAt: z.ZodString;
55
+ truncated: z.ZodOptional<z.ZodBoolean>;
56
+ maxRows: z.ZodOptional<z.ZodNumber>;
57
+ }, z.core.$strip>;
58
+ }, z.core.$strip>, z.ZodObject<{
59
+ mode: z.ZodLiteral<"load">;
60
+ datasetId: z.ZodString;
61
+ page: z.ZodNumber;
62
+ pageSize: z.ZodNumber;
63
+ totalRows: z.ZodNumber;
64
+ totalPages: z.ZodNumber;
65
+ rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
66
+ }, z.core.$strip>, z.ZodObject<{
67
+ mode: z.ZodLiteral<"delete">;
68
+ datasetId: z.ZodString;
69
+ deleted: z.ZodLiteral<true>;
70
+ }, z.core.$strip>], "mode">;
71
+ }, z.core.$strip>, readonly [{
72
+ readonly reason: "datasetid_required";
73
+ readonly code: JsonRpcErrorCode.ValidationError;
74
+ readonly when: "Mode summary, load, or delete was selected without a datasetId";
75
+ readonly recovery: "Call mode=list first to discover available dataset IDs, then retry with one.";
76
+ }, {
77
+ readonly reason: "dataset_not_found";
78
+ readonly code: JsonRpcErrorCode.NotFound;
79
+ readonly when: "Requested dataset is not present in the store (never existed or already expired)";
80
+ readonly recovery: "Run mode=list to confirm available datasets, or rerun the find_* tool that produced it.";
81
+ }, {
82
+ readonly reason: "dataset_rows_missing";
83
+ readonly code: JsonRpcErrorCode.NotFound;
84
+ readonly when: "Dataset metadata is present but the row payload was lost or partially expired";
85
+ readonly recovery: "Delete the stale dataset via mode=delete and rerun the find_* tool that produced it.";
86
+ }]>;
87
+ //# sourceMappingURL=brapi-manage-dataset.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"brapi-manage-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-manage-dataset.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0HjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8G7B,CAAC"}