@cyanheads/sanctions-screening-mcp-server 0.1.0

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

@@ -0,0 +1,176 @@
+/**
+ * @fileoverview `sanctions_get_entity` — the full GLEIF Level 1 record for one
+ * LEI, plus any sanctions hits screened against the same legal name. Combines
+ * the who-is-who reference data with a cross-reference screen so an agent sees
+ * both "who is this entity" and "is its name on a watchlist" in one call.
+ * @module mcp-server/tools/definitions/get-entity.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getScreeningService } from '../../../services/screening/screening-service.js';
+import { SOURCE_CODES, SOURCE_LABELS } from '../../../services/screening/types.js';
+import { SCREENING_CAVEAT } from './_shared.js';
+const LEI_RE = /^[A-Z0-9]{18}[0-9]{2}$/;
+export const getEntityTool = tool('sanctions_get_entity', {
+    title: 'sanctions-screening-mcp-server: get entity',
+    description: 'Fetch the full GLEIF Level 1 record for one LEI: legal name, other/trading names, legal and headquarters addresses, registration status, jurisdiction, registration authority and ID, and last-update date — plus any sanctions hits screened against the same legal name across all loaded watchlists. The screening cross-reference is a screening AID: a hit is a candidate to verify against the official source, and no hit is not a clearance. LEI must be a 20-character GLEIF identifier (18 alphanumerics + 2 check digits).',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        lei: z
+            .string()
+            .regex(LEI_RE, 'LEI must be 20 chars: 18 alphanumerics + 2 check digits (e.g. 5493001KJTIIGC8Y1R12).')
+            .describe('The 20-character GLEIF Legal Entity Identifier to look up.'),
+    }),
+    output: z.object({
+        lei: z.string().describe('The 20-character GLEIF Legal Entity Identifier.'),
+        legalName: z.string().describe('Registered legal name.'),
+        otherNames: z.array(z.string()).describe('Other / trading names published in the LEI record.'),
+        jurisdiction: z.string().optional().describe('Legal jurisdiction (ISO code), when published.'),
+        status: z.string().optional().describe('Registration status (e.g. ISSUED, LAPSED).'),
+        legalAddress: z.string().optional().describe('Single-line legal address, when published.'),
+        headquartersAddress: z
+            .string()
+            .optional()
+            .describe('Single-line headquarters address, when published.'),
+        registrationAuthorityId: z
+            .string()
+            .optional()
+            .describe('Registration authority (RA) code, when published.'),
+        registrationAuthorityEntityId: z
+            .string()
+            .optional()
+            .describe("The entity's ID at its registration authority, when published."),
+        lastUpdate: z
+            .string()
+            .optional()
+            .describe('ISO 8601 last-update timestamp from the LEI record.'),
+        sanctionsHits: z
+            .array(z
+            .object({
+            source: z
+                .enum(['ofac_sdn', 'ofac_consolidated', 'eu', 'uk', 'un'])
+                .describe('Watchlist the candidate is on.'),
+            sourceLabel: z.string().describe('Human-readable source list name.'),
+            sourceEntryId: z
+                .string()
+                .describe('Source entry ID — pass to sanctions_get_designation.'),
+            primaryName: z.string().describe('Primary published name of the designation.'),
+            matchedName: z
+                .string()
+                .describe("The name/alias that matched the entity's legal name."),
+            matchType: z
+                .enum(['exact', 'strong', 'approximate'])
+                .describe('exact / strong / approximate match classification.'),
+            score: z
+                .number()
+                .optional()
+                .describe('Raw Jaro-Winkler similarity (0–1) for approximate hits only.'),
+        })
+            .describe("A potential watchlist match on the entity's legal name — verify, do not assume."))
+            .describe("Sanctions screening cross-reference on the entity's legal name."),
+        caveat: z
+            .string()
+            .describe('Decision-support caveat — the screening cross-reference is an aid, not a determination.'),
+    }),
+    errors: [
+        {
+            reason: 'lei_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No GLEIF entity exists for the given LEI in the mirror.',
+            recovery: 'Resolve the entity name with sanctions_resolve_entity to obtain a valid LEI first.',
+        },
+        {
+            reason: 'mirror_not_ready',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The GLEIF (LEI) mirror has never completed an initial sync.',
+            retryable: true,
+            recovery: 'Run the mirror:init lifecycle script to load the GLEIF golden copy, then retry.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getScreeningService();
+        if (!(await svc.leiReady())) {
+            throw ctx.fail('mirror_not_ready', 'The local GLEIF (LEI) mirror is not yet populated.', {
+                ...ctx.recoveryFor('mirror_not_ready'),
+            });
+        }
+        const entity = await svc.getLeiEntity(input.lei);
+        if (!entity) {
+            throw ctx.fail('lei_not_found', `No GLEIF entity with LEI "${input.lei}".`, {
+                ...ctx.recoveryFor('lei_not_found'),
+            });
+        }
+        // Cross-reference screen on the legal name — only when the sanctions mirror is ready.
+        let sanctionsHits = [];
+        if (await svc.sanctionsReady()) {
+            const screen = await svc.screenName({
+                query: entity.legalName,
+                entityType: 'any',
+                matchMode: 'strict',
+                // Cross-reference screen: strict only. Auto-fuzzy on a generic legal
+                // name floods the result with single-common-token false positives.
+                autoFallback: false,
+                sources: [...SOURCE_CODES],
+                limit: 25,
+            }, ctx);
+            sanctionsHits = screen.hits;
+        }
+        return {
+            lei: entity.lei,
+            legalName: entity.legalName,
+            otherNames: entity.otherNames,
+            ...(entity.jurisdiction ? { jurisdiction: entity.jurisdiction } : {}),
+            ...(entity.status ? { status: entity.status } : {}),
+            ...(entity.legalAddress ? { legalAddress: entity.legalAddress } : {}),
+            ...(entity.headquartersAddress ? { headquartersAddress: entity.headquartersAddress } : {}),
+            ...(entity.registrationAuthorityId
+                ? { registrationAuthorityId: entity.registrationAuthorityId }
+                : {}),
+            ...(entity.registrationAuthorityEntityId
+                ? { registrationAuthorityEntityId: entity.registrationAuthorityEntityId }
+                : {}),
+            ...(entity.lastUpdate ? { lastUpdate: entity.lastUpdate } : {}),
+            sanctionsHits: sanctionsHits.map((h) => ({
+                source: h.source,
+                sourceLabel: SOURCE_LABELS[h.source],
+                sourceEntryId: h.sourceEntryId,
+                primaryName: h.primaryName,
+                matchedName: h.matchedName,
+                matchType: h.matchType,
+                ...(h.score !== undefined ? { score: h.score } : {}),
+            })),
+            caveat: SCREENING_CAVEAT,
+        };
+    },
+    format: (r) => {
+        const lines = [`# ${r.legalName}`, '', `**LEI:** \`${r.lei}\``];
+        if (r.otherNames.length > 0)
+            lines.push(`**Other names:** ${r.otherNames.join('; ')}`);
+        if (r.jurisdiction)
+            lines.push(`**Jurisdiction:** ${r.jurisdiction}`);
+        if (r.status)
+            lines.push(`**Registration status:** ${r.status}`);
+        if (r.legalAddress)
+            lines.push(`**Legal address:** ${r.legalAddress}`);
+        if (r.headquartersAddress)
+            lines.push(`**HQ address:** ${r.headquartersAddress}`);
+        if (r.registrationAuthorityId) {
+            lines.push(`**Registration authority:** ${r.registrationAuthorityId}${r.registrationAuthorityEntityId ? ` (entity ${r.registrationAuthorityEntityId})` : ''}`);
+        }
+        if (r.lastUpdate)
+            lines.push(`**Last update:** ${r.lastUpdate}`);
+        lines.push('\n## Sanctions screening cross-reference');
+        if (r.sanctionsHits.length === 0) {
+            lines.push('No potential watchlist matches on the legal name (NOT a clearance).');
+        }
+        else {
+            for (const h of r.sanctionsHits) {
+                const scoreStr = h.score !== undefined ? ` · score ${h.score.toFixed(3)}` : '';
+                lines.push(`- **${h.primaryName}** — ${h.sourceLabel} (\`${h.source}\`, entry ${h.sourceEntryId}), ${h.matchType}${scoreStr}, matched "${h.matchedName}"`);
+            }
+        }
+        lines.push(`\n> ${r.caveat}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-entity.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,306 @@
+/**
+ * @fileoverview Barrel collecting all tool definitions into `allToolDefinitions`
+ * for `createApp()`.
+ * @module mcp-server/tools/definitions/index
+ */
+import { getDesignationTool } from './get-designation.tool.js';
+import { getEntityTool } from './get-entity.tool.js';
+import { listSourcesTool } from './list-sources.tool.js';
+import { resolveEntityTool } from './resolve-entity.tool.js';
+import { screenNameTool } from './screen-name.tool.js';
+import { traceOwnershipTool } from './trace-ownership.tool.js';
+export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    source: import("zod").ZodEnum<{
+        ofac_sdn: "ofac_sdn";
+        ofac_consolidated: "ofac_consolidated";
+        eu: "eu";
+        uk: "uk";
+        un: "un";
+    }>;
+    entryId: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    source: import("zod").ZodEnum<{
+        ofac_sdn: "ofac_sdn";
+        ofac_consolidated: "ofac_consolidated";
+        eu: "eu";
+        uk: "uk";
+        un: "un";
+    }>;
+    sourceLabel: import("zod").ZodString;
+    sourceEntryId: import("zod").ZodString;
+    entityType: import("zod").ZodEnum<{
+        unknown: "unknown";
+        person: "person";
+        organization: "organization";
+        vessel: "vessel";
+        aircraft: "aircraft";
+    }>;
+    primaryName: import("zod").ZodString;
+    program: import("zod").ZodOptional<import("zod").ZodString>;
+    legalBasis: import("zod").ZodOptional<import("zod").ZodString>;
+    designationDate: import("zod").ZodOptional<import("zod").ZodString>;
+    aliases: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        nameType: import("zod").ZodEnum<{
+            primary: "primary";
+            aka: "aka";
+            fka: "fka";
+            "low-quality-aka": "low-quality-aka";
+        }>;
+    }, import("zod/v4/core").$strip>>;
+    identifiers: import("zod").ZodArray<import("zod").ZodObject<{
+        type: import("zod").ZodString;
+        value: import("zod").ZodString;
+        country: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    addresses: import("zod").ZodArray<import("zod").ZodObject<{
+        full: import("zod").ZodString;
+        country: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    datesOfBirth: import("zod").ZodArray<import("zod").ZodObject<{
+        date: import("zod").ZodOptional<import("zod").ZodString>;
+        place: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    nationalities: import("zod").ZodArray<import("zod").ZodString>;
+    remarks: import("zod").ZodOptional<import("zod").ZodString>;
+    caveat: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "designation_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No designation exists for the given source + entry ID in the mirror.";
+    readonly recovery: "Verify the source and entryId via sanctions_screen_name, which returns the exact sourceEntryId for each hit.";
+}, {
+    readonly reason: "mirror_not_ready";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The sanctions mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the sanctions lists, then retry.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    lei: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    lei: import("zod").ZodString;
+    legalName: import("zod").ZodString;
+    otherNames: import("zod").ZodArray<import("zod").ZodString>;
+    jurisdiction: import("zod").ZodOptional<import("zod").ZodString>;
+    status: import("zod").ZodOptional<import("zod").ZodString>;
+    legalAddress: import("zod").ZodOptional<import("zod").ZodString>;
+    headquartersAddress: import("zod").ZodOptional<import("zod").ZodString>;
+    registrationAuthorityId: import("zod").ZodOptional<import("zod").ZodString>;
+    registrationAuthorityEntityId: import("zod").ZodOptional<import("zod").ZodString>;
+    lastUpdate: import("zod").ZodOptional<import("zod").ZodString>;
+    sanctionsHits: import("zod").ZodArray<import("zod").ZodObject<{
+        source: import("zod").ZodEnum<{
+            ofac_sdn: "ofac_sdn";
+            ofac_consolidated: "ofac_consolidated";
+            eu: "eu";
+            uk: "uk";
+            un: "un";
+        }>;
+        sourceLabel: import("zod").ZodString;
+        sourceEntryId: import("zod").ZodString;
+        primaryName: import("zod").ZodString;
+        matchedName: import("zod").ZodString;
+        matchType: import("zod").ZodEnum<{
+            exact: "exact";
+            strong: "strong";
+            approximate: "approximate";
+        }>;
+        score: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    caveat: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "lei_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No GLEIF entity exists for the given LEI in the mirror.";
+    readonly recovery: "Resolve the entity name with sanctions_resolve_entity to obtain a valid LEI first.";
+}, {
+    readonly reason: "mirror_not_ready";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The GLEIF (LEI) mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the GLEIF golden copy, then retry.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    sanctionsReady: import("zod").ZodBoolean;
+    sanctionsAsOf: import("zod").ZodOptional<import("zod").ZodString>;
+    leiReady: import("zod").ZodBoolean;
+    leiAsOf: import("zod").ZodOptional<import("zod").ZodString>;
+    sources: import("zod").ZodArray<import("zod").ZodObject<{
+        code: import("zod").ZodString;
+        label: import("zod").ZodString;
+        recordCount: import("zod").ZodNumber;
+        url: import("zod").ZodString;
+        license: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, undefined, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    jurisdiction: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    matchMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+        strict: "strict";
+        fuzzy: "fuzzy";
+    }>>;
+    status: import("zod").ZodDefault<import("zod").ZodEnum<{
+        any: "any";
+        issued: "issued";
+        lapsed: "lapsed";
+    }>>;
+    minScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    matches: import("zod").ZodArray<import("zod").ZodObject<{
+        lei: import("zod").ZodString;
+        legalName: import("zod").ZodString;
+        matchedName: import("zod").ZodString;
+        matchType: import("zod").ZodEnum<{
+            exact: "exact";
+            strong: "strong";
+            approximate: "approximate";
+        }>;
+        score: import("zod").ZodOptional<import("zod").ZodNumber>;
+        jurisdiction: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "mirror_not_ready";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The GLEIF (LEI) mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the GLEIF golden copy, then retry; check sanctions_list_sources for readiness.";
+}], {
+    readonly normalizedQuery: import("zod").ZodString;
+    readonly matchModeUsed: import("zod").ZodString;
+    readonly totalCount: import("zod").ZodNumber;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    entityType: import("zod").ZodDefault<import("zod").ZodEnum<{
+        any: "any";
+        person: "person";
+        organization: "organization";
+        vessel: "vessel";
+        aircraft: "aircraft";
+    }>>;
+    matchMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+        strict: "strict";
+        fuzzy: "fuzzy";
+    }>>;
+    minScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+    sources: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        ofac_sdn: "ofac_sdn";
+        ofac_consolidated: "ofac_consolidated";
+        eu: "eu";
+        uk: "uk";
+        un: "un";
+    }>>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    hits: import("zod").ZodArray<import("zod").ZodObject<{
+        source: import("zod").ZodEnum<{
+            ofac_sdn: "ofac_sdn";
+            ofac_consolidated: "ofac_consolidated";
+            eu: "eu";
+            uk: "uk";
+            un: "un";
+        }>;
+        sourceLabel: import("zod").ZodString;
+        sourceEntryId: import("zod").ZodString;
+        entityType: import("zod").ZodEnum<{
+            unknown: "unknown";
+            person: "person";
+            organization: "organization";
+            vessel: "vessel";
+            aircraft: "aircraft";
+        }>;
+        primaryName: import("zod").ZodString;
+        matchedName: import("zod").ZodString;
+        matchedNameType: import("zod").ZodEnum<{
+            primary: "primary";
+            aka: "aka";
+            fka: "fka";
+            "low-quality-aka": "low-quality-aka";
+        }>;
+        matchType: import("zod").ZodEnum<{
+            exact: "exact";
+            strong: "strong";
+            approximate: "approximate";
+        }>;
+        score: import("zod").ZodOptional<import("zod").ZodNumber>;
+        program: import("zod").ZodOptional<import("zod").ZodString>;
+        designationDate: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    caveat: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "mirror_not_ready";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The sanctions mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the sanctions lists, then retry; check sanctions_list_sources for readiness.";
+}], {
+    readonly normalizedQuery: import("zod").ZodString;
+    readonly matchModeUsed: import("zod").ZodString;
+    readonly totalCount: import("zod").ZodNumber;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    lei: import("zod").ZodString;
+    direction: import("zod").ZodDefault<import("zod").ZodEnum<{
+        parents: "parents";
+        children: "children";
+        both: "both";
+    }>>;
+    depth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    screenNodes: import("zod").ZodDefault<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    rootLei: import("zod").ZodString;
+    nodes: import("zod").ZodArray<import("zod").ZodObject<{
+        lei: import("zod").ZodString;
+        legalName: import("zod").ZodString;
+        jurisdiction: import("zod").ZodOptional<import("zod").ZodString>;
+        status: import("zod").ZodOptional<import("zod").ZodString>;
+        depth: import("zod").ZodNumber;
+        role: import("zod").ZodEnum<{
+            root: "root";
+            parent: "parent";
+            child: "child";
+        }>;
+        sanctionsHits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            source: import("zod").ZodEnum<{
+                ofac_sdn: "ofac_sdn";
+                ofac_consolidated: "ofac_consolidated";
+                eu: "eu";
+                uk: "uk";
+                un: "un";
+            }>;
+            sourceLabel: import("zod").ZodString;
+            sourceEntryId: import("zod").ZodString;
+            primaryName: import("zod").ZodString;
+            matchedName: import("zod").ZodString;
+            matchType: import("zod").ZodEnum<{
+                exact: "exact";
+                strong: "strong";
+                approximate: "approximate";
+            }>;
+            score: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>>;
+    }, import("zod/v4/core").$strip>>;
+    edges: import("zod").ZodArray<import("zod").ZodObject<{
+        childLei: import("zod").ZodString;
+        parentLei: import("zod").ZodString;
+        relationshipType: import("zod").ZodString;
+        relationshipStatus: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    screenedNodeCount: import("zod").ZodNumber;
+    flaggedNodeCount: import("zod").ZodNumber;
+    caveat: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "lei_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No GLEIF entity exists for the root LEI in the mirror.";
+    readonly recovery: "Resolve the entity name with sanctions_resolve_entity to obtain a valid root LEI first.";
+}, {
+    readonly reason: "mirror_not_ready";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The GLEIF (LEI) mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the GLEIF golden copy + relationships, then retry.";
+}], undefined>)[];
+export { getDesignationTool, getEntityTool, listSourcesTool, resolveEntityTool, screenNameTool, traceOwnershipTool, };
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO9B,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Barrel collecting all tool definitions into `allToolDefinitions`
+ * for `createApp()`.
+ * @module mcp-server/tools/definitions/index
+ */
+import { getDesignationTool } from './get-designation.tool.js';
+import { getEntityTool } from './get-entity.tool.js';
+import { listSourcesTool } from './list-sources.tool.js';
+import { resolveEntityTool } from './resolve-entity.tool.js';
+import { screenNameTool } from './screen-name.tool.js';
+import { traceOwnershipTool } from './trace-ownership.tool.js';
+export const allToolDefinitions = [
+    screenNameTool,
+    getDesignationTool,
+    listSourcesTool,
+    resolveEntityTool,
+    getEntityTool,
+    traceOwnershipTool,
+];
+export { getDesignationTool, getEntityTool, listSourcesTool, resolveEntityTool, screenNameTool, traceOwnershipTool, };
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc;IACd,kBAAkB;IAClB,eAAe;IACf,iBAAiB;IACjB,aAAa;IACb,kBAAkB;CACnB,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,CAAC"}

package/dist/mcp-server/tools/definitions/list-sources.tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview `sanctions_list_sources` — provenance and freshness for any
+ * result. Lists the sanctions watchlists and GLEIF datasets currently loaded in
+ * the local mirror, each with its record count, source URL, license, and the
+ * mirror's readiness + as-of timestamp. Lets an agent judge staleness before
+ * trusting (or distrusting) a screen.
+ * @module mcp-server/tools/definitions/list-sources.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const listSourcesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    sanctionsReady: z.ZodBoolean;
+    sanctionsAsOf: z.ZodOptional<z.ZodString>;
+    leiReady: z.ZodBoolean;
+    leiAsOf: z.ZodOptional<z.ZodString>;
+    sources: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        recordCount: z.ZodNumber;
+        url: z.ZodString;
+        license: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=list-sources.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-sources.tool.d.ts.map

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