@cyanheads/brapi-mcp-server 0.3.5

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

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview `brapi_find_locations` — find research stations / field sites
+ * by country, abbreviation, type, or free-text. Supports a client-side bbox
+ * filter (minLat/maxLat/minLon/maxLon) applied after the initial page load,
+ * since BrAPI doesn't define a spec-level bounding-box filter. Standard
+ * find_* pattern: distributions + dataset spillover.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-locations.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const brapiFindLocations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    alias: z.ZodOptional<z.ZodString>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    locationNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    countryCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    locationTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    abbreviations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    bbox: z.ZodOptional<z.ZodObject<{
+        minLat: z.ZodOptional<z.ZodNumber>;
+        maxLat: z.ZodOptional<z.ZodNumber>;
+        minLon: z.ZodOptional<z.ZodNumber>;
+        maxLon: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    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<{
+        locationDbId: z.ZodString;
+        locationName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        abbreviation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        countryCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        countryName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        locationType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        longitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        altitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        instituteName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        instituteAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        documentationURL: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    returnedCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    distributions: z.ZodObject<{
+        countryCode: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        locationType: 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-locations.tool.d.ts.map

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

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

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

@@ -0,0 +1,278 @@
+/**
+ * @fileoverview `brapi_find_locations` — find research stations / field sites
+ * by country, abbreviation, type, or free-text. Supports a client-side bbox
+ * filter (minLat/maxLat/minLon/maxLon) applied after the initial page load,
+ * since BrAPI doesn't define a spec-level bounding-box filter. Standard
+ * find_* pattern: distributions + dataset spillover.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-locations.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 LocationRowSchema = z
+    .object({
+    locationDbId: z.string().describe('Server-side identifier for the location.'),
+    locationName: z.string().nullish().describe('Display name.'),
+    abbreviation: z.string().nullish().describe('Short abbreviation.'),
+    countryCode: z.string().nullish().describe('ISO 3166-1 alpha-3 country code.'),
+    countryName: z.string().nullish().describe('Display name of the country.'),
+    locationType: z
+        .string()
+        .nullish()
+        .describe('Type of location (e.g. "Research Station", "Field", "Greenhouse").'),
+    latitude: z.number().nullish().describe('WGS84 latitude in decimal degrees.'),
+    longitude: z.number().nullish().describe('WGS84 longitude in decimal degrees.'),
+    altitude: z.number().nullish().describe('Altitude in meters above sea level.'),
+    instituteName: z.string().nullish().describe('Owning institute display name.'),
+    instituteAddress: z.string().nullish().describe('Postal address of the institute.'),
+    documentationURL: z.string().nullish().describe('URL pointing at extra documentation.'),
+})
+    .passthrough()
+    .describe('One BrAPI location record.');
+const OutputSchema = z.object({
+    alias: z.string().describe('Alias of the registered BrAPI connection the call used.'),
+    results: z
+        .array(LocationRowSchema)
+        .describe('Location rows returned in-context (up to loadLimit). Bbox filter is applied after the upstream fetch.'),
+    returnedCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('Length of `results[]` after any bbox filtering.'),
+    totalCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('Total rows reported by the server (or the post-bbox count when a bbox filter is active).'),
+    hasMore: z.boolean().describe('True when more rows exist beyond the returned set.'),
+    distributions: z
+        .object({
+        countryCode: z
+            .record(z.string(), z.number())
+            .describe('ISO country code → count of locations in that country.'),
+        locationType: z
+            .record(z.string(), z.number())
+            .describe('Location type → count of locations of that type.'),
+    })
+        .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 (bbox malformed, filter overrides, capability gaps, etc.).'),
+    appliedFilters: z
+        .record(z.string(), z.unknown())
+        .describe('The final filter map sent to the server (named + extraFilters).'),
+});
+export const brapiFindLocations = tool('brapi_find_locations', {
+    description: 'Find research stations / field sites by country, abbreviation, type, location ID, or free-text. Optional bbox parameter restricts rows to a latitude/longitude window. Returns a dataset handle when the upstream total exceeds loadLimit.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        alias: AliasInput,
+        locations: z.array(z.string()).optional().describe('Filter by locationDbIds.'),
+        locationNames: z.array(z.string()).optional().describe('Filter by display name.'),
+        countryCodes: z.array(z.string()).optional().describe('ISO 3166-1 alpha-3 country codes.'),
+        locationTypes: z
+            .array(z.string())
+            .optional()
+            .describe('Location type — e.g. "Research Station", "Field".'),
+        abbreviations: z.array(z.string()).optional().describe('Short location abbreviations.'),
+        bbox: z
+            .object({
+            minLat: z
+                .number()
+                .min(-90)
+                .max(90)
+                .optional()
+                .describe('Minimum latitude in WGS84 decimal degrees.'),
+            maxLat: z
+                .number()
+                .min(-90)
+                .max(90)
+                .optional()
+                .describe('Maximum latitude in WGS84 decimal degrees.'),
+            minLon: z
+                .number()
+                .min(-180)
+                .max(180)
+                .optional()
+                .describe('Minimum longitude in WGS84 decimal degrees.'),
+            maxLon: z
+                .number()
+                .min(-180)
+                .max(180)
+                .optional()
+                .describe('Maximum longitude in WGS84 decimal degrees.'),
+        })
+            .optional()
+            .describe('Optional post-fetch bounding box. All four corners must be set to activate the filter.'),
+        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: 'locations', method: 'GET' }, ctx, capabilityLookup);
+        const warnings = [];
+        const filters = mergeFilters({
+            locationDbIds: input.locations,
+            locationNames: input.locationNames,
+            countryCodes: input.countryCodes,
+            locationTypes: input.locationTypes,
+            abbreviations: input.abbreviations,
+        }, input.extraFilters, warnings);
+        const loadLimit = input.loadLimit ?? config.loadLimit;
+        const firstPage = await loadInitialPage(client, connection, '/locations', filters, loadLimit, ctx);
+        const { fullRows, dataset: datasetMeta } = await maybeSpill({
+            firstPage,
+            client,
+            connection,
+            path: '/locations',
+            filters,
+            source: 'find_locations',
+            loadLimit,
+            ctx,
+            store: datasetStore,
+        });
+        const bbox = normalizeBbox(input.bbox, warnings);
+        const filteredFull = bbox ? fullRows.filter((r) => insideBbox(r, bbox)) : fullRows;
+        const filteredReturned = bbox
+            ? firstPage.rows.filter((r) => insideBbox(r, bbox))
+            : firstPage.rows;
+        if (bbox && fullRows.length > 0 && filteredFull.length === 0) {
+            warnings.push(`bbox excluded all ${fullRows.length} upstream location(s). Verify the latitude/longitude window matches the server's coordinate convention.`);
+        }
+        else if (bbox && filteredFull.length < fullRows.length) {
+            warnings.push(`bbox excluded ${fullRows.length - filteredFull.length} of ${fullRows.length} upstream location(s).`);
+        }
+        const distributions = {
+            countryCode: computeDistribution(filteredFull, (r) => asString(r.countryCode)),
+            locationType: computeDistribution(filteredFull, (r) => asString(r.locationType)),
+        };
+        const totalCount = bbox ? filteredFull.length : (firstPage.totalCount ?? firstPage.rows.length);
+        const refinementHint = buildRefinementHint(totalCount, loadLimit, distributions);
+        const result = {
+            alias: connection.alias,
+            results: filteredReturned,
+            returnedCount: filteredReturned.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} locations — \`${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('## Locations');
+        if (result.results.length === 0) {
+            lines.push('_No rows returned._');
+        }
+        else {
+            for (const loc of result.results) {
+                const parts = [`**${loc.locationName ?? loc.locationDbId}**`];
+                parts.push(`id=\`${loc.locationDbId}\``);
+                if (loc.abbreviation)
+                    parts.push(`abbr=${loc.abbreviation}`);
+                if (loc.locationType)
+                    parts.push(`type=${loc.locationType}`);
+                if (loc.countryCode)
+                    parts.push(`country=${loc.countryCode}`);
+                if (loc.countryName)
+                    parts.push(`countryName=${loc.countryName}`);
+                if (loc.latitude != null && loc.longitude != null) {
+                    parts.push(`lat=${loc.latitude}`);
+                    parts.push(`lon=${loc.longitude}`);
+                }
+                if (loc.altitude != null)
+                    parts.push(`alt=${loc.altitude}`);
+                if (loc.instituteName)
+                    parts.push(`institute=${loc.instituteName}`);
+                if (loc.instituteAddress)
+                    parts.push(`addr=${loc.instituteAddress}`);
+                if (loc.documentationURL)
+                    parts.push(`docs=${loc.documentationURL}`);
+                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 normalizeBbox(bbox, warnings) {
+    if (!bbox)
+        return;
+    const { minLat, maxLat, minLon, maxLon } = bbox;
+    if (minLat === undefined &&
+        maxLat === undefined &&
+        minLon === undefined &&
+        maxLon === undefined) {
+        return;
+    }
+    if (minLat === undefined ||
+        maxLat === undefined ||
+        minLon === undefined ||
+        maxLon === undefined) {
+        warnings.push('bbox ignored: all four corners (minLat, maxLat, minLon, maxLon) are required.');
+        return;
+    }
+    if (minLat > maxLat || minLon > maxLon) {
+        warnings.push('bbox ignored: min value exceeds max value on latitude or longitude.');
+        return;
+    }
+    return { minLat, maxLat, minLon, maxLon };
+}
+function insideBbox(row, bbox) {
+    const lat = row.latitude;
+    const lon = row.longitude;
+    if (typeof lat !== 'number' || typeof lon !== 'number')
+        return false;
+    return lat >= bbox.minLat && lat <= bbox.maxLat && lon >= bbox.minLon && lon <= bbox.maxLon;
+}
+//# sourceMappingURL=brapi-find-locations.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brapi-find-locations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-find-locations.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EACL,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC7E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC5D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1E,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,OAAO,EAAE;SACT,QAAQ,CAAC,oEAAoE,CAAC;IACjF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC7E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC9E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC9E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACnF,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CACxF,CAAC;KACD,WAAW,EAAE;KACb,QAAQ,CAAC,4BAA4B,CAAC,CAAC;AAE1C,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACrF,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,iBAAiB,CAAC;SACxB,QAAQ,CACP,uGAAuG,CACxG;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,CACP,0FAA0F,CAC3F;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACnF,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,WAAW,EAAE,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;aAC9B,QAAQ,CAAC,wDAAwD,CAAC;QACrE,YAAY,EAAE,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;aAC9B,QAAQ,CAAC,kDAAkD,CAAC;KAChE,CAAC;SACD,QAAQ,CAAC,uDAAuD,CAAC;IACpE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,wEAAwE,CACzE;IACD,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CAAC,iEAAiE,CAAC;CAC/E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE;IAC7D,WAAW,EACT,4OAA4O;IAC9O,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAC9E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACjF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC1F,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,mDAAmD,CAAC;QAChE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACvF,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC;YACN,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,EAAE,CAAC;iBACR,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;YACzD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,EAAE,CAAC;iBACR,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;YACzD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,GAAG,CAAC;iBACT,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6CAA6C,CAAC;YAC1D,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,GAAG,CAAC;iBACT,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6CAA6C,CAAC;SAC3D,CAAC;aACD,QAAQ,EAAE;aACV,QAAQ,CACP,wFAAwF,CACzF;QACH,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,iBAAiB;KAChC,CAAC;IACF,MAAM,EAAE,YAAY;IAEpB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QAEjC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;QAEzE,MAAM,gBAAgB,GAA8C,EAAE,CAAC;QACvE,IAAI,UAAU,CAAC,YAAY;YAAE,gBAAgB,CAAC,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC;QAC7E,MAAM,YAAY,CAAC,MAAM,CACvB,UAAU,CAAC,OAAO,EAClB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,EACvC,GAAG,EACH,gBAAgB,CACjB,CAAC;QAEF,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,YAAY,CAC1B;YACE,aAAa,EAAE,KAAK,CAAC,SAAS;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,EACD,KAAK,CAAC,YAAY,EAClB,QAAQ,CACT,CAAC;QAEF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,eAAe,CACrC,MAAM,EACN,UAAU,EACV,YAAY,EACZ,OAAO,EACP,SAAS,EACT,GAAG,CACJ,CAAC;QAEF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,UAAU,CAAC;YAC1D,SAAS;YACT,MAAM;YACN,UAAU;YACV,IAAI,EAAE,YAAY;YAClB,OAAO;YACP,MAAM,EAAE,gBAAgB;YACxB,SAAS;YACT,GAAG;YACH,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnF,MAAM,gBAAgB,GAAG,IAAI;YAC3B,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QACnB,IAAI,IAAI,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CACX,qBAAqB,QAAQ,CAAC,MAAM,yGAAyG,CAC9I,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,IAAI,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzD,QAAQ,CAAC,IAAI,CACX,iBAAiB,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,OAAO,QAAQ,CAAC,MAAM,wBAAwB,CACrG,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG;YACpB,WAAW,EAAE,mBAAmB,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAC9E,YAAY,EAAE,mBAAmB,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;SACjF,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChG,MAAM,cAAc,GAAG,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAEjF,MAAM,MAAM,GAAW;YACrB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,OAAO,EAAE,gBAAuD;YAChE,aAAa,EAAE,gBAAgB,CAAC,MAAM;YACtC,UAAU;YACV,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,aAAa;YACb,QAAQ;YACR,cAAc,EAAE,OAAO;SACxB,CAAC;QACF,IAAI,cAAc;YAAE,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;QAC3D,IAAI,WAAW;YAAE,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,aAAa,OAAO,MAAM,CAAC,UAAU,kBAAkB,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QAChG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CACR,8CAA8C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC,MAAM,CAAC,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,oCAAoC,EAAE,CACzK,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,2BAA2B,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAa,CAAC,KAAK,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;gBACxE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;gBACzC,IAAI,GAAG,CAAC,YAAY;oBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC7D,IAAI,GAAG,CAAC,YAAY;oBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC7D,IAAI,GAAG,CAAC,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC9D,IAAI,GAAG,CAAC,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;gBAClE,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;oBAClD,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAClC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBACrC,CAAC;gBACD,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC5D,IAAI,GAAG,CAAC,aAAa;oBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;gBACpE,IAAI,GAAG,CAAC,gBAAgB;oBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACrE,IAAI,GAAG,CAAC,gBAAgB;oBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACrE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC;AASH,SAAS,aAAa,CACpB,IAOa,EACb,QAAkB;IAElB,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChD,IACE,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS,EACpB,CAAC;QACD,OAAO;IACT,CAAC;IACD,IACE,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS,EACpB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IACD,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACrF,OAAO;IACT,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,GAA4B,EAAE,IAAU;IAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrE,OAAO,GAAG,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;AAC9F,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * @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 { z } from '@cyanheads/mcp-ts-core';
+export declare const brapiFindObservations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    alias: z.ZodOptional<z.ZodString>;
+    studies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    germplasm: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    observationUnits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    observations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    seasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    programs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    trials: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    observationLevels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    timestampFrom: z.ZodOptional<z.ZodString>;
+    timestampTo: 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<{
+        observationDbId: z.ZodOptional<z.ZodString>;
+        observationUnitDbId: z.ZodOptional<z.ZodString>;
+        observationUnitName: z.ZodOptional<z.ZodString>;
+        observationVariableDbId: z.ZodOptional<z.ZodString>;
+        observationVariableName: z.ZodOptional<z.ZodString>;
+        studyDbId: z.ZodOptional<z.ZodString>;
+        studyName: z.ZodOptional<z.ZodString>;
+        germplasmDbId: z.ZodOptional<z.ZodString>;
+        germplasmName: z.ZodOptional<z.ZodString>;
+        observationLevel: z.ZodOptional<z.ZodString>;
+        season: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            seasonDbId: z.ZodOptional<z.ZodString>;
+            year: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            season: z.ZodOptional<z.ZodString>;
+            seasonName: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>]>>;
+        value: z.ZodOptional<z.ZodString>;
+        observationTimeStamp: z.ZodOptional<z.ZodString>;
+        collector: z.ZodOptional<z.ZodString>;
+        uploadedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    returnedCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    distributions: z.ZodObject<{
+        observationVariableName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        studyName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        germplasmName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        observationLevel: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        season: 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-observations.tool.d.ts.map

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

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