@cyanheads/interpro-mcp-server 0.0.0-stage → 0.1.1

package/dist/mcp-server/tools/definitions/interpro-get-clan.tool.js

@@ -0,0 +1,259 @@
+/**
+ * @fileoverview Clan metadata, budget-bounded relationship slices, and paged members.
+ * @module mcp-server/tools/definitions/interpro-get-clan.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { BUDGET_LABEL, fitWithinBudget } from '../../../services/interpro/budget.js';
+import { continuation, decodeCursor, encodeCursor, pageGuidance, } from '../../../services/interpro/cursors.js';
+import { formatInterpro, normalizeImages, projectWikipediaThumbnails, } from '../../../services/interpro/format.js';
+import { getInterproService } from '../../../services/interpro/interpro-service.js';
+import { orderRelationships, RelationshipGraphSchema, sliceRelationships, } from '../../../services/interpro/relationships.js';
+import { resolveClan } from '../../../services/interpro/routing.js';
+import { AccessionSchema, detailSchema, EntrySummarySchema, JsonValueSchema, listSchema, optionalString, PageSchema, } from '../../../services/interpro/schemas.js';
+import { UPSTREAM_ERRORS } from '../../../services/interpro/upstream-errors.js';
+const MAX_LIMIT = 100;
+const ClanSourceSchema = z.enum(['pfam', 'cdd', 'pirsf']).describe('Set database.');
+const ClanMetadataSchema = z
+    .object({
+    accession: z.string().describe('Upstream set accession.'),
+    source_database: z.string().describe('Upstream set database.'),
+})
+    .catchall(JsonValueSchema);
+const MemberSchema = z
+    .object({
+    metadata: EntrySummarySchema.describe('Complete member entry metadata.'),
+    sets: z.array(JsonValueSchema).describe('Complete upstream set associations.'),
+})
+    .catchall(JsonValueSchema);
+const RelationshipsPageSchema = z.object({
+    totalNodes: z.number().int().nonnegative().describe('Nodes in the complete graph.'),
+    totalLinks: z.number().int().nonnegative().describe('Links in the complete graph.'),
+    offset: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('Requested relationshipOffset: position of the first returned item among every node sorted by accession, followed by every link sorted by source, target, and method.'),
+    returnedNodes: z.number().int().nonnegative().describe('Nodes in this slice.'),
+    returnedLinks: z.number().int().nonnegative().describe('Links in this slice.'),
+    hasMore: z.boolean().describe('Whether nodes or links remain after this slice.'),
+    nextOffset: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('relationshipOffset of the next slice; present only when hasMore is true.'),
+});
+/** Retrieve one clan and a page of members under one shared deadline. */
+export const interproGetClan = tool('interpro_get_clan', {
+    title: 'InterPro clan metadata and members',
+    description: 'Retrieve a Pfam, CDD, or PIRSF clan/set and a cursor page of member entries; optionally include its relationship graph, returned in slices that fit the response budget and paged with relationshipOffset.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    auth: ['tool:interpro_get_clan:read'],
+    input: z.object({
+        accession: AccessionSchema.describe('Set accession, such as CL0016 (Pfam), cl21453 (CDD), or PIRSF000047; no URL syntax.'),
+        sourceDatabase: optionalString(ClanSourceSchema).describe('Inferred from uppercase CL (Pfam), lowercase cl (CDD), or PIRSF; supply explicitly for mixed-case CL prefixes.'),
+        includeRelationships: z
+            .boolean()
+            .default(false)
+            .describe('Include the relationship graph, one slice per call that fits the response budget; defaults to false.'),
+        relationshipOffset: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Position of the first relationship item to return, counting nodes, then links; defaults to 0. A value above 0 requires includeRelationships: true; pass relationshipsPage.nextOffset to continue.'),
+        includeThumbnail: z
+            .boolean()
+            .default(false)
+            .describe('Include each Wikipedia thumbnail image, base64 data often tens of KB; defaults to false.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(MAX_LIMIT)
+            .default(20)
+            .describe('Member page size from 1 to 100; defaults to 20.'),
+        cursor: optionalString(z.string().trim().max(4096)).describe('Opaque nextCursor with unchanged accession, sourceDatabase, and includeRelationships; limit, relationshipOffset, and includeThumbnail may change.'),
+    }),
+    output: z.object({
+        accession: z.string().describe('Canonical requested clan accession.'),
+        sourceDatabase: ClanSourceSchema,
+        clan: ClanMetadataSchema.describe('Complete metadata, with relationships and Wikipedia thumbnails omitted unless requested; requested relationships hold the slice relationshipsPage locates.'),
+        relationshipsIncluded: z.boolean().describe('Whether relationship projection was requested.'),
+        relationshipsPage: RelationshipsPageSchema.optional().describe('Position and totals of the relationship slice; present only when includeRelationships is true.'),
+        members: z
+            .array(MemberSchema.describe('Complete upstream member record.'))
+            .describe('Complete upstream member records.'),
+        page: PageSchema.describe('Member continuation and total.'),
+        url: z.string().describe('Canonical InterPro clan website URL.'),
+        sourceUrl: z.string().describe('Official clan metadata API source URL.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Next relationship slice call, omitted relationships or thumbnails, or empty-page guidance.'),
+        totalCount: z.number().optional().describe('Total matching members.'),
+        truncated: z.boolean().optional().describe('More members remain.'),
+        shown: z.number().int().optional().describe('Members returned in this page.'),
+        cap: z.number().int().optional().describe('Requested member page size.'),
+        effectiveQuery: z
+            .string()
+            .optional()
+            .describe('Applied canonical target, relationship, and thumbnail selection.'),
+    },
+    errors: [
+        {
+            reason: 'database_mismatch',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Explicit database conflicts with accession routing.',
+            retryable: false,
+            recovery: 'Retry interpro_get_clan with sourceDatabase pfam for uppercase CL, cdd for lowercase cl, or pirsf for PIRSF; supply pfam or cdd explicitly for mixed-case CL prefixes.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'accession_source_unknown',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Accession has no inferred or explicit database.',
+            retryable: false,
+            recovery: 'Retry interpro_get_clan with sourceDatabase pfam for uppercase CL, cdd for lowercase cl, or pirsf for PIRSF; supply pfam or cdd explicitly for mixed-case CL prefixes.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'relationships_not_requested',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'relationshipOffset above 0 is supplied without includeRelationships: true; 0 is accepted as a no-op.',
+            retryable: false,
+            recovery: 'Repeat interpro_get_clan with includeRelationships: true to page the relationship graph, or omit relationshipOffset.',
+        },
+        {
+            reason: 'clan_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Set metadata returns 204 or 404.',
+            retryable: false,
+            recovery: 'Read set_info with interpro_get_entry, then retry interpro_get_clan with that accession and database.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'entry_withdrawn',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Entry or set returns 410.',
+            retryable: false,
+            recovery: 'Call interpro_search_entries for a current replacement; consult interpro_list_reference with topic databases for source names.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'invalid_cursor',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Cursor decoding or scope fails, or upstream rejects continuation.',
+            retryable: false,
+            recovery: 'Repeat the same tool without cursor to restart pagination, keeping the intended filters.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'upstream_shape_invalid',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Upstream JSON, structure, or continuation is incompatible.',
+            retryable: false,
+            recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.',
+            thrownBy: 'service',
+        },
+        ...UPSTREAM_ERRORS,
+    ],
+    async handler(input, ctx) {
+        if (input.relationshipOffset > 0 && !input.includeRelationships)
+            throw ctx.fail('relationships_not_requested', `relationshipOffset ${input.relationshipOffset} pages the relationship graph, which this call did not request.`);
+        const target = resolveClan(input.accession, input.sourceDatabase);
+        // includeThumbnail shapes only the clan metadata reread on every page, so it stays out of scope.
+        const scope = { ...target, includeRelationships: input.includeRelationships };
+        const cursor = decodeCursor(input.cursor, 'interpro_get_clan', scope);
+        const service = getInterproService();
+        const call = service.begin(ctx);
+        const detail = await service.request(call, ['set', target.sourceDatabase, target.accession], {}, detailSchema(ClanMetadataSchema), { missing: { reason: 'clan_not_found', ...target } });
+        if (!detail.data)
+            throw ctx.fail('upstream_shape_invalid', 'Clan metadata response is missing.');
+        const response = await service.request(call, ['entry', target.sourceDatabase, 'set', target.sourceDatabase, target.accession], { page_size: input.limit, cursor }, listSchema(MemberSchema), { continuation: cursor !== undefined });
+        const thumbnails = projectWikipediaThumbnails(detail.data.metadata, input.includeThumbnail, 'interpro_get_clan');
+        const { relationships: graph, ...clan } = normalizeImages(thumbnails.metadata);
+        const members = normalizeImages(response.data?.results ?? []);
+        const next = continuation(response.data?.next ?? null, new Set(cursor ? [cursor] : []));
+        const page = {
+            total: response.data?.count ?? 0,
+            returned: members.length,
+            limit: input.limit,
+            hasMore: next !== undefined,
+            ...(next ? { nextCursor: encodeCursor('interpro_get_clan', scope, next) } : {}),
+        };
+        ctx.enrich.total(page.total);
+        ctx.enrich.echo(JSON.stringify({ ...scope, includeThumbnail: input.includeThumbnail }));
+        const result = (clanValue, relationshipsPage) => ({
+            ...target,
+            clan: clanValue,
+            relationshipsIncluded: input.includeRelationships,
+            ...(relationshipsPage ? { relationshipsPage } : {}),
+            members,
+            page,
+            url: `https://www.ebi.ac.uk/interpro/set/${target.sourceDatabase}/${encodeURIComponent(target.accession)}/`,
+            sourceUrl: detail.sourceUrl,
+        });
+        const notices = [];
+        let output = result(clan);
+        if (!input.includeRelationships)
+            notices.push('Relationships are omitted; set includeRelationships=true to page the relationship graph.');
+        else {
+            const parsed = RelationshipGraphSchema.safeParse(graph);
+            if (!parsed.success)
+                throw ctx.fail('upstream_shape_invalid', 'Clan relationships lack node and link arrays.');
+            const ordered = orderRelationships(parsed.data);
+            const offset = input.relationshipOffset;
+            const total = (ordered?.nodes.length ?? 0) + (ordered?.links.length ?? 0);
+            const sliceAt = (count) => sliceRelationships(ordered, offset, count);
+            const withSlice = ({ relationships, page: slicePage }) => result(relationships === undefined ? clan : { ...clan, relationships }, slicePage);
+            const fit = fitWithinBudget(Math.max(0, total - offset), (n) => withSlice(sliceAt(n)));
+            const slice = sliceAt(fit.count);
+            output = fit.output;
+            const { totalNodes, totalLinks, returnedNodes, returnedLinks, nextOffset } = slice.page;
+            if (!total)
+                notices.push('InterPro returned no relationship nodes or links for this clan.');
+            else if (offset >= total)
+                notices.push(`relationshipOffset ${offset} is past the end of the relationship graph (${totalNodes} nodes and ${totalLinks} links, ${total} items); repeat interpro_get_clan with a relationshipOffset below ${total}, or 0 to start over.`);
+            if (fit.oversized) {
+                const roomier = [
+                    ...(input.includeThumbnail ? ['includeThumbnail: false'] : []),
+                    ...(input.limit > 1 ? ['a smaller limit'] : []),
+                ];
+                notices.push(`The clan metadata and member page leave no room in the ${BUDGET_LABEL}, so this slice holds one item and exceeds it${roomier.length ? `; repeat with ${roomier.join(' or ')} for larger slices` : ''}.`);
+            }
+            if (nextOffset !== undefined) {
+                const nextCall = {
+                    accession: target.accession,
+                    sourceDatabase: target.sourceDatabase,
+                    includeRelationships: true,
+                    relationshipOffset: nextOffset,
+                    limit: input.limit,
+                    ...(input.includeThumbnail ? { includeThumbnail: true } : {}),
+                    ...(input.cursor ? { cursor: input.cursor } : {}),
+                };
+                notices.push(`This relationship slice holds items ${offset} to ${nextOffset - 1} of ${total}, nodes first, then links (${returnedNodes} of ${totalNodes} nodes, ${returnedLinks} of ${totalLinks} links). Continue with interpro_get_clan ${JSON.stringify(nextCall)}${input.limit > 1 ? '; a smaller limit leaves more of the response budget to each slice' : ''}.`);
+            }
+        }
+        if (thumbnails.notice)
+            notices.push(thumbnails.notice);
+        if (!members.length)
+            notices.push('This member page is empty; the clan metadata remains available.');
+        if (next) {
+            notices.push(pageGuidance('interpro_get_clan', 'members', input.limit, MAX_LIMIT));
+            ctx.enrich.truncated({
+                shown: members.length,
+                cap: input.limit,
+                guidance: notices.join(' '),
+            });
+        }
+        else if (notices.length)
+            ctx.enrich.notice(notices.join(' '));
+        return output;
+    },
+    format: formatInterpro,
+});
+//# sourceMappingURL=interpro-get-clan.tool.js.map

package/dist/mcp-server/tools/definitions/interpro-get-clan.tool.js.map

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

package/dist/mcp-server/tools/definitions/interpro-get-entry.tool.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @fileoverview Complete InterPro and member entry metadata.
+ * @module mcp-server/tools/definitions/interpro-get-entry.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+/** Retrieve one complete entry with deterministic accession routing. */
+export declare const interproGetEntry: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    accession: z.ZodString;
+    sourceDatabase: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+        antifam: "antifam";
+        cathgene3d: "cathgene3d";
+        cdd: "cdd";
+        hamap: "hamap";
+        interpro: "interpro";
+        ncbifam: "ncbifam";
+        panther: "panther";
+        pfam: "pfam";
+        pirsf: "pirsf";
+        prints: "prints";
+        profile: "profile";
+        prosite: "prosite";
+        sfld: "sfld";
+        smart: "smart";
+        ssf: "ssf";
+    }>>, unknown>;
+    includeThumbnail: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    accession: z.ZodString;
+    sourceDatabase: z.ZodEnum<{
+        antifam: "antifam";
+        cathgene3d: "cathgene3d";
+        cdd: "cdd";
+        hamap: "hamap";
+        interpro: "interpro";
+        ncbifam: "ncbifam";
+        panther: "panther";
+        pfam: "pfam";
+        pirsf: "pirsf";
+        prints: "prints";
+        profile: "profile";
+        prosite: "prosite";
+        sfld: "sfld";
+        smart: "smart";
+        ssf: "ssf";
+    }>;
+    entry: z.ZodObject<{
+        accession: z.ZodString;
+        source_database: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            short: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$catchall<z.ZodJSONSchema>>>>;
+    }, z.core.$catchall<z.ZodJSONSchema>>;
+    url: z.ZodString;
+    sourceUrl: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "database_mismatch";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Explicit database conflicts with accession routing.";
+    readonly retryable: false;
+    readonly recovery: "Call interpro_list_reference with topic accession_patterns, then retry with the matching sourceDatabase.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "accession_source_unknown";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Accession has no inferred or explicit database.";
+    readonly retryable: false;
+    readonly recovery: "Call interpro_list_reference with topic accession_patterns, or supply the sourceDatabase reported by interpro_search_entries.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "entry_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Entry detail returns 204 or 404, or the accession is a set accession.";
+    readonly retryable: false;
+    readonly recovery: "Call interpro_search_entries in the correct database, or interpro_list_reference with topic accession_patterns.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "entry_withdrawn";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Entry or set returns 410.";
+    readonly retryable: false;
+    readonly recovery: "Call interpro_search_entries for a current replacement; consult interpro_list_reference with topic databases for source names.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "upstream_shape_invalid";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Upstream JSON, structure, or continuation is incompatible.";
+    readonly retryable: false;
+    readonly recovery: "Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: 'upstream_response_too_large';
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'An upstream response exceeds 4 MiB.';
+    readonly retryable: false;
+    readonly recovery: 'Retry list tools with a smaller limit, or retrieve individual members with interpro_get_entry instead of a large clan.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_rejected';
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'InterPro returns an unhandled redirect or client rejection.';
+    readonly retryable: false;
+    readonly recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_unavailable';
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'InterPro has a network or server failure; HTTP 501 is not retryable.';
+    readonly retryable: true;
+    readonly recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_timeout';
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: 'InterPro returns HTTP 408/504 or an attempt exceeds its deadline.';
+    readonly retryable: true;
+    readonly recovery: 'Retry with a smaller limit where available, then repeat the same tool after waiting.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_rate_limited';
+    readonly code: JsonRpcErrorCode.RateLimited;
+    readonly when: 'InterPro returns HTTP 429.';
+    readonly retryable: true;
+    readonly recovery: 'Wait for retryAfter when supplied, then repeat the same tool with fewer concurrent calls.';
+    readonly thrownBy: 'service';
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=interpro-get-entry.tool.d.ts.map

package/dist/mcp-server/tools/definitions/interpro-get-entry.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpro-get-entry.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/interpro-get-entry.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAiBjE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6G3B,CAAC"}

package/dist/mcp-server/tools/definitions/interpro-get-entry.tool.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Complete InterPro and member entry metadata.
+ * @module mcp-server/tools/definitions/interpro-get-entry.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { formatInterpro, normalizeImages, projectWikipediaThumbnails, } from '../../../services/interpro/format.js';
+import { getInterproService } from '../../../services/interpro/interpro-service.js';
+import { resolveEntry } from '../../../services/interpro/routing.js';
+import { AccessionSchema, detailSchema, EntryMetadataSchema, optionalString, SourceDatabaseSchema, } from '../../../services/interpro/schemas.js';
+import { UPSTREAM_ERRORS } from '../../../services/interpro/upstream-errors.js';
+/** Retrieve one complete entry with deterministic accession routing. */
+export const interproGetEntry = tool('interpro_get_entry', {
+    title: 'InterPro entry metadata',
+    description: 'Retrieve one InterPro or member-database entry, including description, hierarchy, member signatures, GO terms, literature, cross-references, clan membership, and coverage counters.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    auth: ['tool:interpro_get_entry:read'],
+    input: z.object({
+        accession: AccessionSchema.describe('InterPro or member-database entry accession, such as IPR011615 or PF00870; no URL syntax.'),
+        sourceDatabase: optionalString(SourceDatabaseSchema).describe('Database slug; inferred from standard accession prefixes when omitted.'),
+        includeThumbnail: z
+            .boolean()
+            .default(false)
+            .describe('Include each Wikipedia thumbnail image, base64 data often hundreds of KB; defaults to false.'),
+    }),
+    output: z.object({
+        accession: z.string().describe('Canonical requested accession.'),
+        sourceDatabase: SourceDatabaseSchema,
+        entry: EntryMetadataSchema.describe('Complete upstream metadata, preserving sparse annotations; Wikipedia thumbnails are omitted unless includeThumbnail is true.'),
+        url: z.string().describe('Canonical InterPro website URL.'),
+        sourceUrl: z.string().describe('Official API source URL.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Omitted Wikipedia thumbnail size and how to include it.'),
+    },
+    errors: [
+        {
+            reason: 'database_mismatch',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Explicit database conflicts with accession routing.',
+            retryable: false,
+            recovery: 'Call interpro_list_reference with topic accession_patterns, then retry with the matching sourceDatabase.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'accession_source_unknown',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Accession has no inferred or explicit database.',
+            retryable: false,
+            recovery: 'Call interpro_list_reference with topic accession_patterns, or supply the sourceDatabase reported by interpro_search_entries.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'entry_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Entry detail returns 204 or 404, or the accession is a set accession.',
+            retryable: false,
+            recovery: 'Call interpro_search_entries in the correct database, or interpro_list_reference with topic accession_patterns.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'entry_withdrawn',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Entry or set returns 410.',
+            retryable: false,
+            recovery: 'Call interpro_search_entries for a current replacement; consult interpro_list_reference with topic databases for source names.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'upstream_shape_invalid',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Upstream JSON, structure, or continuation is incompatible.',
+            retryable: false,
+            recovery: 'Retry the same tool later; call interpro_list_reference with topic release to check upstream availability.',
+            thrownBy: 'service',
+        },
+        ...UPSTREAM_ERRORS,
+    ],
+    async handler(input, ctx) {
+        const target = resolveEntry(input.accession, input.sourceDatabase);
+        const service = getInterproService();
+        const response = await service.request(service.begin(ctx), ['entry', target.sourceDatabase, target.accession], {}, detailSchema(EntryMetadataSchema), { missing: { reason: 'entry_not_found', ...target } });
+        if (!response.data)
+            throw ctx.fail('upstream_shape_invalid', 'Entry metadata response is missing.');
+        const { metadata, notice } = projectWikipediaThumbnails(response.data.metadata, input.includeThumbnail, 'interpro_get_entry');
+        if (notice)
+            ctx.enrich.notice(notice);
+        return {
+            ...target,
+            entry: normalizeImages(metadata),
+            url: `https://www.ebi.ac.uk/interpro/entry/${target.sourceDatabase}/${encodeURIComponent(target.accession)}/`,
+            sourceUrl: response.sourceUrl,
+        };
+    },
+    format: formatInterpro,
+});
+//# sourceMappingURL=interpro-get-entry.tool.js.map

package/dist/mcp-server/tools/definitions/interpro-get-entry.tool.js.map

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