@cyanheads/brapi-mcp-server 0.3.5

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

@@ -0,0 +1,290 @@
+/**
+ * @fileoverview `brapi_find_germplasm` — search germplasm by name, synonym,
+ * accession, attribute, or free text. Matches BrAPI's registered-synonym
+ * semantics. Returns distributions for crop / genus / species / collection
+ * and spills to DatasetStore when the upstream total exceeds loadLimit.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-germplasm.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 GermplasmRowSchema = z
+    .object({
+    germplasmDbId: z.string().describe('Server-side identifier for the germplasm.'),
+    germplasmName: z.string().nullish().describe('Display name.'),
+    germplasmPUI: z.string().nullish().describe('Persistent unique identifier (URI).'),
+    commonCropName: z.string().nullish().describe('Common crop name (e.g. "Maize", "Wheat").'),
+    accessionNumber: z.string().nullish().describe('Gene-bank catalog number.'),
+    genus: z.string().nullish().describe('Botanical genus.'),
+    species: z.string().nullish().describe('Botanical species.'),
+    subtaxa: z.string().nullish().describe('Botanical subtaxa (subspecies, variety, etc.).'),
+    defaultDisplayName: z.string().nullish().describe('Preferred display label.'),
+    pedigree: z.string().nullish().describe('Pedigree as a free-text string (e.g. "A/B//C").'),
+    biologicalStatusOfAccessionDescription: z
+        .string()
+        .nullish()
+        .describe('MCPD biological-status label (wild / landrace / breeding / cultivar, etc.).'),
+    germplasmOrigin: z
+        .array(z
+        .object({})
+        .passthrough()
+        .describe('One origin record (collection coordinates and uncertainty per BrAPI v2).'))
+        .nullish()
+        .describe('Origin records — array of collection-site objects per BrAPI v2.'),
+    countryOfOriginCode: z.string().nullish().describe('ISO 3166-1 alpha-3 country code.'),
+    collection: z.string().nullish().describe('Collection name this accession belongs to.'),
+    instituteCode: z
+        .string()
+        .nullish()
+        .describe('FAO WIEWS institute code of the holding institute.'),
+    instituteName: z.string().nullish().describe('Display name of the holding institute.'),
+    synonyms: z
+        .array(z
+        .object({
+        synonym: z.string().nullish().describe('Synonym value.'),
+        type: z.string().nullish().describe('Synonym type (e.g. "COMMON", "SYNONYM").'),
+    })
+        .passthrough()
+        .describe('Registered synonym for this germplasm.'))
+        .nullish()
+        .describe('All registered synonyms (alternative names).'),
+})
+    .passthrough()
+    .describe('One BrAPI germplasm record.');
+const OutputSchema = z.object({
+    alias: z.string().describe('Alias of the registered BrAPI connection the call used.'),
+    results: z
+        .array(GermplasmRowSchema)
+        .describe('Germplasm 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({
+        commonCropName: z
+            .record(z.string(), z.number())
+            .describe('Common crop name → count of rows for that crop.'),
+        genus: z.record(z.string(), z.number()).describe('Genus → count of rows with that genus.'),
+        species: z
+            .record(z.string(), z.number())
+            .describe('Species → count of rows with that species.'),
+        collection: z
+            .record(z.string(), z.number())
+            .describe('Collection name → count of rows in that collection.'),
+        countryOfOriginCode: z
+            .record(z.string(), z.number())
+            .describe('ISO country code → count of rows from that country.'),
+    })
+        .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 brapiFindGermplasm = tool('brapi_find_germplasm', {
+    description: 'Find germplasm by name, synonym, accession number, PUI, crop, or free-text query. Matches across registered synonyms. Returns a dataset handle when the upstream total exceeds loadLimit.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        alias: AliasInput,
+        names: z.array(z.string()).optional().describe('Filter by germplasm display names.'),
+        germplasmDbIds: z.array(z.string()).optional().describe('Filter by DbIds.'),
+        germplasmPUIs: z.array(z.string()).optional().describe('Persistent unique identifiers.'),
+        accessionNumbers: z
+            .array(z.string())
+            .optional()
+            .describe('Filter by accession numbers (gene-bank catalog codes).'),
+        crops: z.array(z.string()).optional().describe('Filter by common crop names.'),
+        synonyms: z.array(z.string()).optional().describe('Match registered synonyms.'),
+        collections: z.array(z.string()).optional().describe('Filter by germplasm collection names.'),
+        genus: z.string().optional().describe('Botanical genus.'),
+        species: z.string().optional().describe('Botanical species.'),
+        text: z.string().optional().describe('Free-text query. 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: 'germplasm', method: 'GET' }, ctx, capabilityLookup);
+        const warnings = [];
+        const filters = mergeFilters({
+            germplasmNames: input.names,
+            germplasmDbIds: input.germplasmDbIds,
+            germplasmPUIs: input.germplasmPUIs,
+            accessionNumbers: input.accessionNumbers,
+            commonCropNames: input.crops,
+            synonyms: input.synonyms,
+            collections: input.collections,
+            genus: input.genus,
+            species: input.species,
+            searchText: input.text,
+        }, input.extraFilters, warnings);
+        const loadLimit = input.loadLimit ?? config.loadLimit;
+        const firstPage = await loadInitialPage(client, connection, '/germplasm', filters, loadLimit, ctx);
+        const { fullRows, dataset: datasetMeta } = await maybeSpill({
+            firstPage,
+            client,
+            connection,
+            path: '/germplasm',
+            filters,
+            source: 'find_germplasm',
+            loadLimit,
+            ctx,
+            store: datasetStore,
+        });
+        const distributions = {
+            commonCropName: computeDistribution(fullRows, (r) => asString(r.commonCropName)),
+            genus: computeDistribution(fullRows, (r) => asString(r.genus)),
+            species: computeDistribution(fullRows, (r) => asString(r.species)),
+            collection: computeDistribution(fullRows, (r) => asString(r.collection)),
+            countryOfOriginCode: computeDistribution(fullRows, (r) => asString(r.countryOfOriginCode)),
+        };
+        const totalCount = firstPage.totalCount ?? firstPage.rows.length;
+        const refinementHint = buildRefinementHint(totalCount, loadLimit, distributions);
+        // Heuristic: if the user asked for a text filter and the upstream returned
+        // every row that matches all the *other* filters (i.e. the text didn't
+        // narrow anything), the server probably doesn't honor the filter.
+        if (input.text &&
+            totalCount > 0 &&
+            firstPage.totalCount !== undefined &&
+            firstPage.rows.length === firstPage.totalCount &&
+            !hasRowsMatchingText(firstPage.rows, input.text)) {
+            warnings.push(`Free-text filter '${input.text}' may not be honored by this server — none of the returned rows obviously match the query string.`);
+        }
+        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} germplasm — \`${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('## Germplasm');
+        if (result.results.length === 0) {
+            lines.push('_No rows returned._');
+        }
+        else {
+            for (const g of result.results) {
+                const parts = [
+                    `**${g.germplasmName ?? g.defaultDisplayName ?? g.germplasmDbId}**`,
+                ];
+                parts.push(`id=\`${g.germplasmDbId}\``);
+                if (g.germplasmPUI)
+                    parts.push(`pui=${g.germplasmPUI}`);
+                if (g.accessionNumber)
+                    parts.push(`accession=${g.accessionNumber}`);
+                if (g.commonCropName)
+                    parts.push(`crop=${g.commonCropName}`);
+                if (g.genus)
+                    parts.push(`genus=${g.genus}`);
+                if (g.species)
+                    parts.push(`species=${g.species}`);
+                if (g.subtaxa)
+                    parts.push(`subtaxa=${g.subtaxa}`);
+                if (g.countryOfOriginCode)
+                    parts.push(`country=${g.countryOfOriginCode}`);
+                if (g.collection)
+                    parts.push(`collection=${g.collection}`);
+                if (g.instituteCode)
+                    parts.push(`institute=${g.instituteCode}`);
+                if (g.instituteName)
+                    parts.push(`instituteName=${g.instituteName}`);
+                if (g.germplasmOrigin?.length)
+                    parts.push(`germplasmOrigin=${g.germplasmOrigin.length} record(s)`);
+                if (g.biologicalStatusOfAccessionDescription)
+                    parts.push(`status=${g.biologicalStatusOfAccessionDescription}`);
+                if (g.pedigree)
+                    parts.push(`pedigree=${g.pedigree}`);
+                if (g.defaultDisplayName)
+                    parts.push(`displayName=${g.defaultDisplayName}`);
+                if (g.synonyms?.length) {
+                    const synStr = g.synonyms
+                        .map((s) => `${s.synonym ?? '?'}${s.type ? ` (${s.type})` : ''}`)
+                        .join(',');
+                    parts.push(`synonyms=${synStr}`);
+                }
+                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 hasRowsMatchingText(rows, text) {
+    const needle = text.toLowerCase();
+    const containsNeedle = (value) => typeof value === 'string' && value.toLowerCase().includes(needle);
+    for (const row of rows) {
+        if (containsNeedle(row.germplasmName) ||
+            containsNeedle(row.germplasmPUI) ||
+            containsNeedle(row.accessionNumber) ||
+            containsNeedle(row.defaultDisplayName)) {
+            return true;
+        }
+        if (Array.isArray(row.synonyms)) {
+            for (const entry of row.synonyms) {
+                if (entry &&
+                    typeof entry === 'object' &&
+                    containsNeedle(entry.synonym)) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=brapi-find-germplasm.tool.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview `brapi_find_images` — filter images by observation unit,
+ * study, observation, descriptive ontology, file name, or MIME type. Returns
+ * metadata only; pull bytes via `brapi_get_image`. Spills the full set to
+ * DatasetStore when the upstream total exceeds loadLimit.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-images.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const brapiFindImages: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    alias: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    observationUnits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    observations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    studies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    imageFileNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    descriptiveOntologyTerms: z.ZodOptional<z.ZodArray<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<{
+        imageDbId: z.ZodString;
+        imageName: z.ZodOptional<z.ZodString>;
+        imageFileName: z.ZodOptional<z.ZodString>;
+        imageFileSize: z.ZodOptional<z.ZodNumber>;
+        imageHeight: z.ZodOptional<z.ZodNumber>;
+        imageWidth: z.ZodOptional<z.ZodNumber>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        imageTimeStamp: z.ZodOptional<z.ZodString>;
+        imageURL: z.ZodOptional<z.ZodString>;
+        observationUnitDbId: z.ZodOptional<z.ZodString>;
+        observationUnitName: z.ZodOptional<z.ZodString>;
+        observationDbIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        studyDbId: z.ZodOptional<z.ZodString>;
+        studyName: z.ZodOptional<z.ZodString>;
+        descriptiveOntologyTerms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        copyright: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    returnedCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    distributions: z.ZodObject<{
+        mimeType: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        studyName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        observationUnitName: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        descriptiveOntologyTerms: 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-images.tool.d.ts.map

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

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

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

@@ -0,0 +1,243 @@
+/**
+ * @fileoverview `brapi_find_images` — filter images by observation unit,
+ * study, observation, descriptive ontology, file name, or MIME type. Returns
+ * metadata only; pull bytes via `brapi_get_image`. Spills the full set to
+ * DatasetStore when the upstream total exceeds loadLimit.
+ *
+ * @module mcp-server/tools/definitions/brapi-find-images.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 ImageRowSchema = z
+    .object({
+    imageDbId: z.string().describe('Server-side identifier for the image.'),
+    imageName: z.string().optional().describe('Display name.'),
+    imageFileName: z.string().optional().describe('Original uploaded filename.'),
+    imageFileSize: z.number().optional().describe('File size in bytes.'),
+    imageHeight: z.number().optional().describe('Pixel height.'),
+    imageWidth: z.number().optional().describe('Pixel width.'),
+    mimeType: z.string().optional().describe('MIME type (e.g. "image/jpeg").'),
+    imageTimeStamp: z.string().optional().describe('ISO 8601 capture timestamp.'),
+    imageURL: z
+        .string()
+        .optional()
+        .describe('URL where the bytes live (may be relative to baseUrl or absolute).'),
+    observationUnitDbId: z
+        .string()
+        .optional()
+        .describe('FK to the observation unit this image depicts.'),
+    observationUnitName: z.string().optional().describe('Display name of the observation unit.'),
+    observationDbIds: z
+        .array(z.string().describe('Observation identifier.'))
+        .optional()
+        .describe('FKs to observations this image is evidence for.'),
+    studyDbId: z.string().optional().describe('FK to the study the image belongs to.'),
+    studyName: z.string().optional().describe('Display name of the study.'),
+    descriptiveOntologyTerms: z
+        .array(z.string().describe('Ontology term ID or label.'))
+        .optional()
+        .describe('Descriptive ontology tags (e.g. "CO_334:plot").'),
+    copyright: z.string().optional().describe('Copyright or rights notice.'),
+    description: z.string().optional().describe('Free-text description.'),
+})
+    .passthrough()
+    .describe('One BrAPI image metadata record.');
+const OutputSchema = z.object({
+    alias: z.string().describe('Alias of the registered BrAPI connection the call used.'),
+    results: z
+        .array(ImageRowSchema)
+        .describe('Image metadata 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({
+        mimeType: z
+            .record(z.string(), z.number())
+            .describe('MIME type → count of images with that type.'),
+        studyName: z
+            .record(z.string(), z.number())
+            .describe('Study name → count of images in that study.'),
+        observationUnitName: z
+            .record(z.string(), z.number())
+            .describe('Observation unit name → count of images tied to that unit.'),
+        descriptiveOntologyTerms: z
+            .record(z.string(), z.number())
+            .describe('Ontology term → count of images tagged with that term.'),
+    })
+        .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 brapiFindImages = tool('brapi_find_images', {
+    description: 'Filter images by observation unit, observation, study, descriptive ontology term, file name, or MIME type. Returns metadata only — use brapi_get_image to fetch bytes inline. Returns a dataset handle when the upstream total exceeds loadLimit.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        alias: AliasInput,
+        images: z.array(z.string()).optional().describe('Filter by imageDbIds.'),
+        observationUnits: z.array(z.string()).optional().describe('Filter by observationUnitDbIds.'),
+        observations: z.array(z.string()).optional().describe('Filter by observationDbIds.'),
+        studies: z.array(z.string()).optional().describe('Filter by studyDbIds.'),
+        imageFileNames: z.array(z.string()).optional().describe('Filter by uploaded file name.'),
+        mimeTypes: z
+            .array(z.string())
+            .optional()
+            .describe('Filter by MIME type — e.g. "image/jpeg", "image/png".'),
+        descriptiveOntologyTerms: z
+            .array(z.string())
+            .optional()
+            .describe('Filter by ontology tags (e.g. "CO_334:plot").'),
+        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: 'images', method: 'GET' }, ctx, capabilityLookup);
+        const warnings = [];
+        const filters = mergeFilters({
+            imageDbIds: input.images,
+            observationUnitDbIds: input.observationUnits,
+            observationDbIds: input.observations,
+            studyDbIds: input.studies,
+            imageFileNames: input.imageFileNames,
+            mimeTypes: input.mimeTypes,
+            descriptiveOntologyTerms: input.descriptiveOntologyTerms,
+        }, input.extraFilters, warnings);
+        const loadLimit = input.loadLimit ?? config.loadLimit;
+        const firstPage = await loadInitialPage(client, connection, '/images', filters, loadLimit, ctx);
+        const { fullRows, dataset: datasetMeta } = await maybeSpill({
+            firstPage,
+            client,
+            connection,
+            path: '/images',
+            filters,
+            source: 'find_images',
+            loadLimit,
+            ctx,
+            store: datasetStore,
+        });
+        const distributions = {
+            mimeType: computeDistribution(fullRows, (r) => asString(r.mimeType)),
+            studyName: computeDistribution(fullRows, (r) => asString(r.studyName)),
+            observationUnitName: computeDistribution(fullRows, (r) => asString(r.observationUnitName)),
+            descriptiveOntologyTerms: computeDistribution(fullRows, (r) => {
+                const terms = r.descriptiveOntologyTerms;
+                if (!Array.isArray(terms))
+                    return;
+                return terms.filter((t) => typeof t === 'string' && t.length > 0);
+            }),
+        };
+        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} images — \`${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('## Images');
+        if (result.results.length === 0) {
+            lines.push('_No rows returned._');
+        }
+        else {
+            for (const img of result.results) {
+                const parts = [`**${img.imageName ?? img.imageFileName ?? img.imageDbId}**`];
+                parts.push(`id=\`${img.imageDbId}\``);
+                if (img.imageFileName)
+                    parts.push(`file=${img.imageFileName}`);
+                if (img.mimeType)
+                    parts.push(`mime=${img.mimeType}`);
+                if (img.imageWidth && img.imageHeight) {
+                    parts.push(`${img.imageWidth}×${img.imageHeight}`);
+                }
+                if (img.imageFileSize)
+                    parts.push(`size=${img.imageFileSize}B`);
+                if (img.observationUnitName)
+                    parts.push(`unit=${img.observationUnitName}`);
+                if (img.observationUnitDbId)
+                    parts.push(`unitDbId=${img.observationUnitDbId}`);
+                if (img.observationDbIds?.length)
+                    parts.push(`obs=${img.observationDbIds.join(',')}`);
+                if (img.studyName)
+                    parts.push(`study=${img.studyName}`);
+                if (img.studyDbId)
+                    parts.push(`studyDbId=${img.studyDbId}`);
+                if (img.descriptiveOntologyTerms?.length) {
+                    parts.push(`terms=${img.descriptiveOntologyTerms.join(',')}`);
+                }
+                if (img.imageTimeStamp)
+                    parts.push(`time=${img.imageTimeStamp}`);
+                if (img.imageURL)
+                    parts.push(`url=${img.imageURL}`);
+                if (img.copyright)
+                    parts.push(`©${img.copyright}`);
+                if (img.description)
+                    parts.push(`desc=${img.description}`);
+                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-images.tool.js.map

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

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