@cyanheads/brapi-mcp-server 0.3.5

package/dist/mcp-server/tools/definitions/brapi-find-observations.tool.js

@@ -0,0 +1,288 @@
+/**
+ * @fileoverview `brapi_find_observations` — pull observation records filtered
+ * by study, germplasm, variable, season, or observation unit. Matches the
+ * find_* pattern: paged single pull capped at loadLimit, distributions across
+ * variable/study/germplasm/level, dataset spillover when the upstream total
+ * exceeds loadLimit.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-observations.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from '../../../config/server-config.js';
+import { getBrapiClient } from '../../../services/brapi-client/index.js';
+import { getCapabilityRegistry } from '../../../services/capability-registry/index.js';
+import { getDatasetStore } from '../../../services/dataset-store/index.js';
+import { DEFAULT_ALIAS, getServerRegistry } from '../../../services/server-registry/index.js';
+import { AliasInput, asString, buildRefinementHint, computeDistribution, DatasetHandleSchema, ExtraFiltersInput, LoadLimitInput, loadInitialPage, maybeSpill, mergeFilters, renderDatasetHandle, renderDistributions, } from '../shared/find-helpers.js';
+const ObservationRowSchema = z
+    .object({
+    observationDbId: z.string().optional().describe('Server-side identifier for the observation.'),
+    observationUnitDbId: z
+        .string()
+        .optional()
+        .describe('FK to the observation unit (plot / plant / sample) that carries the measurement.'),
+    observationUnitName: z.string().optional().describe('Display name of the observation unit.'),
+    observationVariableDbId: z
+        .string()
+        .optional()
+        .describe('FK to the observation variable (trait) measured.'),
+    observationVariableName: z
+        .string()
+        .optional()
+        .describe('Display name of the observation variable.'),
+    studyDbId: z.string().optional().describe('FK to the study the observation belongs to.'),
+    studyName: z.string().optional().describe('Display name of the study.'),
+    germplasmDbId: z
+        .string()
+        .optional()
+        .describe('FK to the germplasm the observation was taken on.'),
+    germplasmName: z.string().optional().describe('Display name of the germplasm.'),
+    observationLevel: z.string().optional().describe('Unit level — e.g. "plot", "plant", "field".'),
+    season: z
+        .union([
+        z.string().describe('Season identifier as a flat string (older BrAPI servers).'),
+        z
+            .object({
+            seasonDbId: z.string().optional().describe('Server-side season identifier.'),
+            year: z
+                .union([
+                z.string().describe('Calendar year as a string (e.g. "2024").'),
+                z.number().describe('Calendar year as an integer (e.g. 2024).'),
+            ])
+                .optional()
+                .describe('Calendar year — accepts string or numeric form depending on server.'),
+            season: z.string().optional().describe('Season label (e.g. "wet", "dry", "Q1").'),
+            seasonName: z
+                .string()
+                .optional()
+                .describe('Season display name (BrAPI v2.1 alternate field).'),
+        })
+            .passthrough()
+            .describe('Structured season block per BrAPI v2.1.'),
+    ])
+        .optional()
+        .describe('Season — either a flat string or a structured `{seasonDbId, year, season}` object depending on the server.'),
+    value: z
+        .string()
+        .optional()
+        .describe('Recorded measurement value (stringified per BrAPI spec).'),
+    observationTimeStamp: z.string().optional().describe('ISO 8601 timestamp of the observation.'),
+    collector: z.string().optional().describe('Name or ID of the person who collected the value.'),
+    uploadedBy: z.string().optional().describe('Name or ID of the user who uploaded the record.'),
+})
+    .passthrough()
+    .describe('One BrAPI observation record.');
+const OutputSchema = z.object({
+    alias: z.string().describe('Alias of the registered BrAPI connection the call used.'),
+    results: z
+        .array(ObservationRowSchema)
+        .describe('Observation rows returned in-context (up to loadLimit).'),
+    returnedCount: z.number().int().nonnegative().describe('Length of `results[]`.'),
+    totalCount: z.number().int().nonnegative().describe('Total rows reported by the server.'),
+    hasMore: z.boolean().describe('True when more rows exist beyond the returned set.'),
+    distributions: z
+        .object({
+        observationVariableName: z
+            .record(z.string(), z.number())
+            .describe('Variable name → count of observations for that trait.'),
+        studyName: z
+            .record(z.string(), z.number())
+            .describe('Study name → count of observations in that study.'),
+        germplasmName: z
+            .record(z.string(), z.number())
+            .describe('Germplasm name → count of observations on that germplasm.'),
+        observationLevel: z
+            .record(z.string(), z.number())
+            .describe('Unit level (plot / plant / field) → count of observations at that level.'),
+        season: z
+            .record(z.string(), z.number())
+            .describe('Season identifier → count of observations in that season.'),
+    })
+        .describe('Value frequency per field across the full result set.'),
+    refinementHint: z
+        .string()
+        .optional()
+        .describe('Suggested next-step query refinement when the result set is large.'),
+    dataset: DatasetHandleSchema.optional().describe('Dataset handle when the full result set was persisted to DatasetStore.'),
+    warnings: z
+        .array(z.string())
+        .describe('Advisory messages (filter overrides, partial data, capability gaps, etc.).'),
+    appliedFilters: z
+        .record(z.string(), z.unknown())
+        .describe('The final filter map sent to the server (named + extraFilters).'),
+});
+export const brapiFindObservations = tool('brapi_find_observations', {
+    description: 'Pull observation records filtered by study, germplasm, variable, season, or observation unit. Returns a dataset handle when the upstream total exceeds loadLimit.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        alias: AliasInput,
+        studies: z.array(z.string()).optional().describe('Filter by studyDbIds.'),
+        germplasm: z.array(z.string()).optional().describe('Filter by germplasmDbIds.'),
+        variables: z.array(z.string()).optional().describe('Filter by observationVariableDbIds.'),
+        observationUnits: z.array(z.string()).optional().describe('Filter by observationUnitDbIds.'),
+        observations: z.array(z.string()).optional().describe('Filter by observationDbIds.'),
+        seasons: z.array(z.string()).optional().describe('Filter by seasonDbIds (e.g. "2022").'),
+        programs: z.array(z.string()).optional().describe('Filter by programDbIds.'),
+        trials: z.array(z.string()).optional().describe('Filter by trialDbIds.'),
+        observationLevels: z
+            .array(z.string())
+            .optional()
+            .describe('Observation unit level (plot, plant, field, etc.).'),
+        timestampFrom: z.string().optional().describe('ISO 8601 start of the observation-time window.'),
+        timestampTo: z.string().optional().describe('ISO 8601 end of the observation-time window.'),
+        loadLimit: LoadLimitInput,
+        extraFilters: ExtraFiltersInput,
+    }),
+    output: OutputSchema,
+    async handler(input, ctx) {
+        const registry = getServerRegistry();
+        const capabilities = getCapabilityRegistry();
+        const client = getBrapiClient();
+        const datasetStore = getDatasetStore();
+        const config = getServerConfig();
+        const connection = await registry.get(ctx, input.alias ?? DEFAULT_ALIAS);
+        const capabilityLookup = {};
+        if (connection.resolvedAuth)
+            capabilityLookup.auth = connection.resolvedAuth;
+        await capabilities.ensure(connection.baseUrl, { service: 'observations', method: 'GET' }, ctx, capabilityLookup);
+        const warnings = [];
+        const filters = mergeFilters({
+            studyDbIds: input.studies,
+            germplasmDbIds: input.germplasm,
+            observationVariableDbIds: input.variables,
+            observationUnitDbIds: input.observationUnits,
+            observationDbIds: input.observations,
+            seasonDbIds: input.seasons,
+            programDbIds: input.programs,
+            trialDbIds: input.trials,
+            observationLevels: input.observationLevels,
+            observationTimeStampRangeStart: input.timestampFrom,
+            observationTimeStampRangeEnd: input.timestampTo,
+        }, input.extraFilters, warnings);
+        const loadLimit = input.loadLimit ?? config.loadLimit;
+        const firstPage = await loadInitialPage(client, connection, '/observations', filters, loadLimit, ctx);
+        const { fullRows, dataset: datasetMeta } = await maybeSpill({
+            firstPage,
+            client,
+            connection,
+            path: '/observations',
+            filters,
+            source: 'find_observations',
+            loadLimit,
+            ctx,
+            store: datasetStore,
+        });
+        const distributions = {
+            observationVariableName: computeDistribution(fullRows, (r) => asString(r.observationVariableName)),
+            studyName: computeDistribution(fullRows, (r) => asString(r.studyName)),
+            germplasmName: computeDistribution(fullRows, (r) => asString(r.germplasmName)),
+            observationLevel: computeDistribution(fullRows, (r) => asString(r.observationLevel)),
+            season: computeDistribution(fullRows, (r) => normalizeSeason(r.season)),
+        };
+        const totalCount = firstPage.totalCount ?? firstPage.rows.length;
+        const refinementHint = buildRefinementHint(totalCount, loadLimit, distributions);
+        const result = {
+            alias: connection.alias,
+            results: firstPage.rows,
+            returnedCount: firstPage.rows.length,
+            totalCount,
+            hasMore: firstPage.hasMore,
+            distributions,
+            warnings,
+            appliedFilters: filters,
+        };
+        if (refinementHint)
+            result.refinementHint = refinementHint;
+        if (datasetMeta)
+            result.dataset = datasetMeta;
+        return result;
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# ${result.returnedCount} of ${result.totalCount} observations — \`${result.alias}\``);
+        lines.push('');
+        if (result.hasMore) {
+            lines.push(`⚠ More rows exist beyond the returned set. ${result.dataset ? `Full set persisted as dataset \`${result.dataset.datasetId}\`.` : 'Narrow filters or raise loadLimit.'}`);
+            lines.push('');
+        }
+        if (result.refinementHint) {
+            lines.push(`**Refinement hint:** ${result.refinementHint}`);
+            lines.push('');
+        }
+        lines.push(`Applied filters: \`${JSON.stringify(result.appliedFilters)}\``);
+        lines.push('');
+        lines.push('## Distributions');
+        lines.push(renderDistributions(result.distributions) || '_No values to summarize._');
+        lines.push('');
+        lines.push('## Observations');
+        if (result.results.length === 0) {
+            lines.push('_No rows returned._');
+        }
+        else {
+            for (const o of result.results) {
+                const parts = [];
+                const label = o.observationVariableName ?? o.observationVariableDbId ?? '?';
+                parts.push(`**${label}**`);
+                if (o.observationVariableDbId)
+                    parts.push(`varDbId=${o.observationVariableDbId}`);
+                if (o.value !== undefined)
+                    parts.push(`= ${o.value}`);
+                if (o.observationDbId)
+                    parts.push(`id=\`${o.observationDbId}\``);
+                if (o.observationUnitName)
+                    parts.push(`unit=${o.observationUnitName}`);
+                if (o.observationUnitDbId)
+                    parts.push(`unitDbId=${o.observationUnitDbId}`);
+                if (o.germplasmName)
+                    parts.push(`germplasm=${o.germplasmName}`);
+                if (o.germplasmDbId)
+                    parts.push(`germplasmDbId=${o.germplasmDbId}`);
+                if (o.studyName)
+                    parts.push(`study=${o.studyName}`);
+                if (o.studyDbId)
+                    parts.push(`studyDbId=${o.studyDbId}`);
+                if (o.observationLevel)
+                    parts.push(`level=${o.observationLevel}`);
+                const seasonLabel = normalizeSeason(o.season);
+                if (seasonLabel)
+                    parts.push(`season=${seasonLabel}`);
+                if (o.observationTimeStamp)
+                    parts.push(`time=${o.observationTimeStamp}`);
+                if (o.collector)
+                    parts.push(`collector=${o.collector}`);
+                if (o.uploadedBy)
+                    parts.push(`uploadedBy=${o.uploadedBy}`);
+                lines.push(`- ${parts.join(' · ')}`);
+            }
+        }
+        if (result.dataset) {
+            lines.push('');
+            lines.push('## Dataset handle');
+            lines.push(...renderDatasetHandle(result.dataset));
+        }
+        if (result.warnings.length > 0) {
+            lines.push('');
+            lines.push('## Warnings');
+            for (const w of result.warnings)
+                lines.push(`- ${w}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+function normalizeSeason(value) {
+    const nonEmpty = (v) => typeof v === 'string' && v.length > 0 ? v : undefined;
+    if (typeof value === 'string')
+        return nonEmpty(value);
+    if (!value || typeof value !== 'object')
+        return;
+    const record = value;
+    const id = nonEmpty(record.seasonDbId);
+    if (id)
+        return id;
+    const label = nonEmpty(record.season) ?? nonEmpty(record.seasonName);
+    const year = nonEmpty(record.year) ?? (typeof record.year === 'number' ? String(record.year) : undefined);
+    if (label)
+        return year ? `${label} ${year}` : label;
+    return year;
+}
+//# sourceMappingURL=brapi-find-observations.tool.js.map

package/dist/mcp-server/tools/definitions/brapi-find-observations.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brapi-find-observations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-find-observations.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview `brapi_find_studies` — locate studies matching crop / trial
+ * type / season / location / program filters. Pulls an initial page and, if
+ * the server reports more rows than loadLimit, spills the union into
+ * DatasetStore and returns a handle. Companion response: per-field
+ * distributions computed from the full row set plus a refinement hint.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-studies.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const brapiFindStudies: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    alias: z.ZodOptional<z.ZodString>;
+    crop: z.ZodOptional<z.ZodString>;
+    trialTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    seasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    programs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    trials: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    studyNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    text: z.ZodOptional<z.ZodString>;
+    loadLimit: z.ZodOptional<z.ZodNumber>;
+    extraFilters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    alias: z.ZodString;
+    results: z.ZodArray<z.ZodObject<{
+        studyDbId: z.ZodString;
+        studyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        studyType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        studyDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        programDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        programName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        trialDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        trialName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        locationDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        locationName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        commonCropName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        seasons: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        endDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        studyCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        studyPUI: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    returnedCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    distributions: z.ZodObject<{
+        programName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        studyType: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        seasons: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        locationName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        commonCropName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    refinementHint: z.ZodOptional<z.ZodString>;
+    dataset: z.ZodOptional<z.ZodObject<{
+        datasetId: z.ZodString;
+        rowCount: z.ZodNumber;
+        sizeBytes: z.ZodNumber;
+        columns: z.ZodArray<z.ZodString>;
+        createdAt: z.ZodString;
+        expiresAt: z.ZodString;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodString>;
+    appliedFilters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=brapi-find-studies.tool.d.ts.map

package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brapi-find-studies.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-find-studies.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA0FjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA6K3B,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.js

@@ -0,0 +1,243 @@
+/**
+ * @fileoverview `brapi_find_studies` — locate studies matching crop / trial
+ * type / season / location / program filters. Pulls an initial page and, if
+ * the server reports more rows than loadLimit, spills the union into
+ * DatasetStore and returns a handle. Companion response: per-field
+ * distributions computed from the full row set plus a refinement hint.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-studies.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from '../../../config/server-config.js';
+import { getBrapiClient } from '../../../services/brapi-client/index.js';
+import { getCapabilityRegistry } from '../../../services/capability-registry/index.js';
+import { getDatasetStore } from '../../../services/dataset-store/index.js';
+import { DEFAULT_ALIAS, getServerRegistry } from '../../../services/server-registry/index.js';
+import { AliasInput, asString, asStringArray, buildRefinementHint, computeDistribution, DatasetHandleSchema, ExtraFiltersInput, LoadLimitInput, loadInitialPage, maybeSpill, mergeFilters, renderDatasetHandle, renderDistributions, } from '../shared/find-helpers.js';
+const StudyRowSchema = z
+    .object({
+    studyDbId: z.string().describe('Server-side identifier for the study.'),
+    studyName: z.string().nullish().describe('Display name.'),
+    studyType: z.string().nullish().describe('E.g. "Yield Trial", "Phenotyping".'),
+    studyDescription: z.string().nullish().describe('Free-form description.'),
+    programDbId: z.string().nullish().describe('FK to program; resolve via `brapi_get_study`.'),
+    programName: z.string().nullish().describe('Display name of the owning program.'),
+    trialDbId: z.string().nullish().describe('FK to trial; resolve via `brapi_get_study`.'),
+    trialName: z.string().nullish().describe('Display name of the owning trial.'),
+    locationDbId: z.string().nullish().describe('FK to location; resolve via `brapi_get_study`.'),
+    locationName: z.string().nullish().describe('Display name of the study site.'),
+    commonCropName: z.string().nullish().describe('Common crop name (e.g. "Maize", "Wheat").'),
+    seasons: z
+        .array(z.string().describe('Season identifier — typically a year like "2022".'))
+        .nullish()
+        .describe('Season identifiers this study spans.'),
+    active: z.boolean().nullish().describe('True while the study is open for data capture.'),
+    startDate: z.string().nullish().describe('ISO 8601 start date.'),
+    endDate: z.string().nullish().describe('ISO 8601 end date.'),
+    studyCode: z.string().nullish().describe('Short code or alias for the study.'),
+    studyPUI: z.string().nullish().describe('Persistent unique identifier (URI).'),
+})
+    .passthrough()
+    .describe('One BrAPI study record.');
+const OutputSchema = z.object({
+    alias: z.string().describe('Alias of the registered BrAPI connection the call used.'),
+    results: z.array(StudyRowSchema).describe('Rows returned in-context (up to loadLimit).'),
+    returnedCount: z.number().int().nonnegative().describe('Length of results[].'),
+    totalCount: z.number().int().nonnegative().describe('Total rows reported by the server.'),
+    hasMore: z.boolean().describe('True when more rows exist beyond the returned set.'),
+    distributions: z
+        .object({
+        programName: z
+            .record(z.string(), z.number())
+            .describe('Program name → count of rows with that program.'),
+        studyType: z
+            .record(z.string(), z.number())
+            .describe('Study type → count of rows with that type.'),
+        seasons: z
+            .record(z.string(), z.number())
+            .describe('Season identifier → count of rows in that season.'),
+        locationName: z
+            .record(z.string(), z.number())
+            .describe('Location name → count of rows at that site.'),
+        commonCropName: z
+            .record(z.string(), z.number())
+            .describe('Common crop name → count of rows for that crop.'),
+    })
+        .describe('Value frequency per field across the full result set.'),
+    refinementHint: z
+        .string()
+        .optional()
+        .describe('Suggested next-step query refinement when the result set is large.'),
+    dataset: DatasetHandleSchema.optional().describe('Dataset handle when the full result set was persisted to DatasetStore.'),
+    warnings: z
+        .array(z.string())
+        .describe('Advisory messages (filter overrides, partial data, etc.).'),
+    appliedFilters: z
+        .record(z.string(), z.unknown())
+        .describe('The final filter map sent to the server (named + extraFilters).'),
+});
+export const brapiFindStudies = tool('brapi_find_studies', {
+    description: 'Locate studies matching crop, trial type, season, location, program, or free-text criteria. Results are enriched with program/trial/location context in one call. Returns a dataset handle when the upstream total exceeds loadLimit.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        alias: AliasInput,
+        crop: z.string().optional().describe('Filter by common crop name (single value).'),
+        trialTypes: z.array(z.string()).optional().describe('Filter by study types.'),
+        seasons: z.array(z.string()).optional().describe('Filter by seasons (e.g. "2022").'),
+        locations: z
+            .array(z.string())
+            .optional()
+            .describe('Filter by locationDbIds (server-side identifiers, not display names).'),
+        programs: z.array(z.string()).optional().describe('Filter by programDbIds.'),
+        trials: z.array(z.string()).optional().describe('Filter by trialDbIds.'),
+        studyNames: z.array(z.string()).optional().describe('Filter by study display name.'),
+        active: z.boolean().optional().describe('Restrict to active / inactive studies.'),
+        text: z
+            .string()
+            .optional()
+            .describe('Free-text search across study fields (server-supported subset).'),
+        loadLimit: LoadLimitInput,
+        extraFilters: ExtraFiltersInput,
+    }),
+    output: OutputSchema,
+    async handler(input, ctx) {
+        const registry = getServerRegistry();
+        const capabilities = getCapabilityRegistry();
+        const client = getBrapiClient();
+        const datasetStore = getDatasetStore();
+        const config = getServerConfig();
+        const connection = await registry.get(ctx, input.alias ?? DEFAULT_ALIAS);
+        const capabilityLookup = {};
+        if (connection.resolvedAuth)
+            capabilityLookup.auth = connection.resolvedAuth;
+        await capabilities.ensure(connection.baseUrl, { service: 'studies', method: 'GET' }, ctx, capabilityLookup);
+        const warnings = [];
+        const filters = mergeFilters({
+            commonCropNames: input.crop !== undefined ? [input.crop] : undefined,
+            studyTypes: input.trialTypes,
+            seasonDbIds: input.seasons,
+            locationDbIds: input.locations,
+            programDbIds: input.programs,
+            trialDbIds: input.trials,
+            studyNames: input.studyNames,
+            active: input.active,
+            searchText: input.text,
+        }, input.extraFilters, warnings);
+        const loadLimit = input.loadLimit ?? config.loadLimit;
+        const firstPage = await loadInitialPage(client, connection, '/studies', filters, loadLimit, ctx);
+        const { fullRows, dataset: datasetMeta } = await maybeSpill({
+            firstPage,
+            client,
+            connection,
+            path: '/studies',
+            filters,
+            source: 'find_studies',
+            loadLimit,
+            ctx,
+            store: datasetStore,
+        });
+        const distributions = {
+            programName: computeDistribution(fullRows, (r) => asString(r.programName)),
+            studyType: computeDistribution(fullRows, (r) => asString(r.studyType)),
+            seasons: computeDistribution(fullRows, (r) => asStringArray(r.seasons)),
+            locationName: computeDistribution(fullRows, (r) => asString(r.locationName)),
+            commonCropName: computeDistribution(fullRows, (r) => asString(r.commonCropName)),
+        };
+        const totalCount = firstPage.totalCount ?? firstPage.rows.length;
+        const refinementHint = buildRefinementHint(totalCount, loadLimit, distributions);
+        ctx.log.info('find_studies completed', {
+            baseUrl: connection.baseUrl,
+            totalCount,
+            returnedCount: firstPage.rows.length,
+            spilled: datasetMeta !== undefined,
+        });
+        const result = {
+            alias: connection.alias,
+            results: firstPage.rows,
+            returnedCount: firstPage.rows.length,
+            totalCount,
+            hasMore: firstPage.hasMore,
+            distributions,
+            warnings,
+            appliedFilters: filters,
+        };
+        if (refinementHint)
+            result.refinementHint = refinementHint;
+        if (datasetMeta)
+            result.dataset = datasetMeta;
+        return result;
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# ${result.returnedCount} of ${result.totalCount} studies — \`${result.alias}\``);
+        lines.push('');
+        if (result.hasMore) {
+            lines.push(`⚠ More rows exist beyond the returned set. ${result.dataset ? `Full set persisted as dataset \`${result.dataset.datasetId}\`.` : 'Narrow filters or raise loadLimit.'}`);
+            lines.push('');
+        }
+        if (result.refinementHint) {
+            lines.push(`**Refinement hint:** ${result.refinementHint}`);
+            lines.push('');
+        }
+        lines.push(`Applied filters: \`${JSON.stringify(result.appliedFilters)}\``);
+        lines.push('');
+        lines.push('## Distributions');
+        const rendered = renderDistributions(result.distributions);
+        lines.push(rendered || '_No values to summarize._');
+        lines.push('');
+        lines.push('## Studies');
+        if (result.results.length === 0) {
+            lines.push('_No rows returned._');
+        }
+        else {
+            for (const study of result.results) {
+                const parts = [`**${study.studyName ?? study.studyDbId}**`];
+                parts.push(`id=\`${study.studyDbId}\``);
+                if (study.studyType)
+                    parts.push(`type=${study.studyType}`);
+                if (study.programName)
+                    parts.push(`program=${study.programName}`);
+                if (study.programDbId)
+                    parts.push(`programDbId=${study.programDbId}`);
+                if (study.trialName)
+                    parts.push(`trial=${study.trialName}`);
+                if (study.trialDbId)
+                    parts.push(`trialDbId=${study.trialDbId}`);
+                if (study.locationName)
+                    parts.push(`location=${study.locationName}`);
+                if (study.locationDbId)
+                    parts.push(`locationDbId=${study.locationDbId}`);
+                if (study.seasons?.length)
+                    parts.push(`seasons=${study.seasons.join(',')}`);
+                if (study.commonCropName)
+                    parts.push(`crop=${study.commonCropName}`);
+                if (study.active != null)
+                    parts.push(`active=${study.active}`);
+                if (study.startDate)
+                    parts.push(`start=${study.startDate}`);
+                if (study.endDate)
+                    parts.push(`end=${study.endDate}`);
+                if (study.studyCode)
+                    parts.push(`code=${study.studyCode}`);
+                if (study.studyPUI)
+                    parts.push(`pui=${study.studyPUI}`);
+                if (study.studyDescription)
+                    parts.push(`desc=${study.studyDescription}`);
+                lines.push(`- ${parts.join(' · ')}`);
+            }
+        }
+        if (result.dataset) {
+            lines.push('');
+            lines.push('## Dataset handle');
+            lines.push(...renderDatasetHandle(result.dataset));
+        }
+        if (result.warnings.length > 0) {
+            lines.push('');
+            lines.push('## Warnings');
+            for (const w of result.warnings)
+                lines.push(`- ${w}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=brapi-find-studies.tool.js.map

package/dist/mcp-server/tools/definitions/brapi-find-studies.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brapi-find-studies.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-find-studies.tool.ts"],"names":[],"mappings":"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"}