@cyanheads/cpsc-recalls-mcp-server 0.1.1

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

@@ -0,0 +1,239 @@
+/**
+ * @fileoverview Full detail for a single CPSC recall by recall number.
+ * @module mcp-server/tools/definitions/cpsc-get-recall
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCpscRecallService } from '../../../services/cpsc-recall/cpsc-recall-service.js';
+/** Static jurisdiction note included in every response. */
+const JURISDICTION = 'CPSC covers consumer products — toys, electronics, furniture, appliances, tools, clothing. ' +
+    'Does NOT cover: food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).';
+export const cpscGetRecall = tool('cpsc_get_recall', {
+    title: 'Get CPSC Recall Detail',
+    description: 'Full detail for a single CPSC recall by recall number. ' +
+        'Returns the complete record: hazard description, remedy instructions, all product variants, ' +
+        'incident/injury reports, images, and the official CPSC recall page URL. ' +
+        'Use after cpsc_search_recalls or cpsc_get_recent to get the full picture on a specific recall. ' +
+        'CPSC jurisdiction: consumer products only — food, vehicles, drugs, and pesticides are covered by other agencies.',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        recall_number: z
+            .string()
+            .regex(/^\d{5}([a-d])?$/)
+            .describe('CPSC recall number. Modern records (2002–present) are 5-digit numeric, e.g. "25043". ' +
+            'Historical records from 1998–2001 may have a letter suffix a–d, e.g. "99003a". ' +
+            'Obtain from cpsc_search_recalls results.'),
+    }),
+    output: z.object({
+        recall_number: z.string().describe('Recall identifier.'),
+        recall_date: z.string().describe('Date issued, ISO 8601.'),
+        last_updated: z.string().describe('Date last published, ISO 8601.'),
+        title: z.string().describe('Official recall title.'),
+        description: z
+            .string()
+            .describe('Full recall description including product identification details. ' +
+            'Model numbers are typically embedded here, not in a structured field.'),
+        cpsc_url: z
+            .string()
+            .describe('Official CPSC recall page — authoritative source for consumers.'),
+        consumer_contact: z
+            .string()
+            .nullable()
+            .describe('Contact information for claiming the remedy. Null when not provided.'),
+        hazards: z
+            .array(z
+            .object({ description: z.string().describe('What is dangerous about this product.') })
+            .describe('A hazard associated with this recall.'))
+            .describe('Hazards — read this first.'),
+        remedy_options: z
+            .array(z.string().describe('Remedy type.'))
+            .describe('Remedy types available: Refund, Repair, Replace, Dispose, Label, New Instructions.'),
+        remedy_instructions: z
+            .string()
+            .describe('Full remedy instructions — exactly what a consumer should do and how to claim.'),
+        products: z
+            .array(z
+            .object({
+            name: z.string().describe('Product name.'),
+            units_recalled: z
+                .string()
+                .describe('Estimated number of units recalled, e.g. "About 2,500".'),
+        })
+            .describe('A product covered by this recall.'))
+            .describe('Products covered. A recall may include multiple products. ' +
+            'Note: model numbers are often in the description text, not a structured field.'),
+        upcs: z
+            .array(z.string().describe('UPC code.'))
+            .describe('UPC codes for this recall (sparse — ~4% of records have UPCs). ' +
+            'UPCs are stored at the recall level in the API, not per-product; ' +
+            'when the recall covers multiple products, UPC-to-product attribution is ambiguous.'),
+        injuries: z
+            .string()
+            .describe('Injury and incident report narrative, e.g. "None reported" or incident count.'),
+        manufacturers: z
+            .array(z.string().describe('Manufacturer name.'))
+            .describe('Manufacturer names (often empty — see importers).'),
+        importers: z.array(z.string().describe('Importer name.')).describe('Importer company names.'),
+        retailers: z
+            .array(z.string().describe('Retailer name with sale date range and price.'))
+            .describe('Retailer names with sale date ranges and price.'),
+        distributors: z
+            .array(z.string().describe('Distributor name.'))
+            .describe('Distributor company names.'),
+        manufacturer_countries: z
+            .array(z.string().describe('Country of manufacture.'))
+            .describe('Countries of manufacture.'),
+        images: z
+            .array(z
+            .object({
+            url: z.string().describe('Image URL.'),
+            caption: z.string().describe('Caption describing what the image shows.'),
+        })
+            .describe('An image from the recall notice.'))
+            .describe('Product and identification images from the recall notice.'),
+        coordinated_recalls: z
+            .array(z.string().describe('URL of coordinated recall by another agency.'))
+            .describe('URLs of coordinated recalls by other agencies (e.g., Canada Health).'),
+        cpsc_jurisdiction: z
+            .string()
+            .describe('CPSC covers consumer products — toys, electronics, furniture, appliances, tools, clothing. ' +
+            'Does NOT cover: food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No recall exists with the given recall number',
+            recovery: 'Verify the recall number (e.g. "25043" for modern records, "99003a" for 1998–2001 historical records). Use cpsc_search_recalls or cpsc_get_recent to find the correct number.',
+        },
+        {
+            reason: 'upstream_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The saferproducts.gov API returned an error or timed out',
+            recovery: 'The CPSC API is occasionally unavailable. Retry in a few seconds.',
+            retryable: true,
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching CPSC recall detail', { recall_number: input.recall_number });
+        const svc = getCpscRecallService();
+        let raw;
+        try {
+            raw = await svc.getByNumber(input.recall_number, ctx);
+        }
+        catch (err) {
+            throw ctx.fail('upstream_error', 'CPSC API request failed.', { ...ctx.recoveryFor('upstream_error') }, { cause: err });
+        }
+        if (!raw) {
+            throw ctx.fail('not_found', `No CPSC recall found with number "${input.recall_number}".`, {
+                ...ctx.recoveryFor('not_found'),
+            });
+        }
+        return {
+            recall_number: raw.RecallNumber,
+            recall_date: raw.RecallDate.slice(0, 10),
+            last_updated: raw.LastPublishDate.slice(0, 10),
+            title: raw.Title,
+            description: raw.Description,
+            cpsc_url: raw.URL,
+            consumer_contact: raw.ConsumerContact,
+            hazards: raw.Hazards.filter((h) => h.Name).map((h) => ({ description: h.Name })),
+            remedy_options: raw.RemedyOptions.map((o) => o.Option).filter(Boolean),
+            remedy_instructions: raw.Remedies.map((r) => r.Name)
+                .filter(Boolean)
+                .join(' '),
+            products: raw.Products.map((p) => ({
+                name: p.Name,
+                units_recalled: p.NumberOfUnits ?? '',
+            })),
+            upcs: raw.ProductUPCs.map((u) => u.UPC).filter(Boolean),
+            injuries: raw.Injuries.map((i) => i.Name)
+                .filter(Boolean)
+                .join(' '),
+            manufacturers: raw.Manufacturers.map((m) => m.Name).filter(Boolean),
+            importers: raw.Importers.map((i) => i.Name).filter(Boolean),
+            retailers: raw.Retailers.map((r) => r.Name).filter(Boolean),
+            distributors: raw.Distributors.map((d) => d.Name).filter(Boolean),
+            manufacturer_countries: raw.ManufacturerCountries.map((c) => c.Country).filter(Boolean),
+            images: raw.Images.map((img) => ({ url: img.URL, caption: img.Caption })),
+            coordinated_recalls: raw.Inconjunctions.map((inj) => inj.URL).filter(Boolean),
+            cpsc_jurisdiction: JURISDICTION,
+        };
+    },
+    format(result) {
+        const lines = [];
+        lines.push(`# [${result.recall_number}] — ${result.title}`);
+        lines.push(`Issued: ${result.recall_date} | Last updated: ${result.last_updated}`);
+        lines.push('');
+        const hazardText = result.hazards.length > 0
+            ? result.hazards.map((h) => h.description).join('; ')
+            : 'Not specified';
+        lines.push(`**⚠️ Hazard:** ${hazardText}`);
+        const remedyTypes = result.remedy_options.length > 0 ? result.remedy_options.join(', ') : 'Not specified';
+        const remedyText = result.remedy_instructions || 'See CPSC recall page.';
+        lines.push(`**✅ Remedy:** ${remedyTypes} — ${remedyText}`);
+        const contact = result.consumer_contact ?? 'See CPSC recall page.';
+        lines.push(`**Contact:** ${contact}`);
+        lines.push('');
+        lines.push('## Products Affected');
+        for (const p of result.products) {
+            lines.push(`- ${p.name} — ${p.units_recalled || 'units not specified'}`);
+        }
+        lines.push('**Note:** Model numbers are in the description text below if not listed here.');
+        if (result.upcs.length > 0) {
+            lines.push(`**UPCs (recall-level):** ${result.upcs.join(', ')} — applies to this recall as a whole`);
+        }
+        lines.push('');
+        lines.push('## Description');
+        lines.push(result.description);
+        lines.push('');
+        lines.push('## Incidents / Injuries');
+        lines.push(result.injuries || 'None reported');
+        lines.push('');
+        if (result.retailers.length > 0) {
+            lines.push('## Sold By');
+            for (const r of result.retailers) {
+                lines.push(`- ${r}`);
+            }
+            lines.push('');
+        }
+        const orgs = [...result.manufacturers, ...result.importers];
+        if (orgs.length > 0) {
+            lines.push('## Manufactured By / Imported By');
+            for (const org of orgs) {
+                lines.push(`- ${org}`);
+            }
+        }
+        if (result.manufacturer_countries.length > 0) {
+            lines.push(`Country of origin: ${result.manufacturer_countries.join(', ')}`);
+        }
+        if (orgs.length > 0 || result.manufacturer_countries.length > 0) {
+            lines.push('');
+        }
+        if (result.distributors.length > 0) {
+            lines.push('## Distributors');
+            for (const d of result.distributors) {
+                lines.push(`- ${d}`);
+            }
+            lines.push('');
+        }
+        if (result.images.length > 0) {
+            lines.push(`## Images (${result.images.length})`);
+            for (const img of result.images) {
+                lines.push(`- ${img.caption} — ${img.url}`);
+            }
+            lines.push('');
+        }
+        if (result.coordinated_recalls.length > 0) {
+            lines.push('## Coordinated Recalls');
+            for (const url of result.coordinated_recalls) {
+                lines.push(`- ${url}`);
+            }
+            lines.push('');
+        }
+        lines.push(`[View official CPSC recall page](${result.cpsc_url})`);
+        lines.push(`CPSC jurisdiction: ${result.cpsc_jurisdiction}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=cpsc-get-recall.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/cpsc-get-recent.tool.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Fetch the most recent CPSC recalls ordered newest-first, scoped to a
+ * configurable date window.
+ * @module mcp-server/tools/definitions/cpsc-get-recent
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const cpscGetRecent: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    days: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    recalls: z.ZodArray<z.ZodObject<{
+        recall_number: z.ZodString;
+        recall_date: z.ZodString;
+        title: z.ZodString;
+        hazards: z.ZodArray<z.ZodString>;
+        remedy_options: z.ZodArray<z.ZodString>;
+        products: z.ZodArray<z.ZodString>;
+        cpsc_url: z.ZodString;
+    }, z.core.$strip>>;
+    period: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        days: z.ZodNumber;
+    }, z.core.$strip>;
+    total_found: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    cpsc_jurisdiction: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The saferproducts.gov API returned an error or timed out";
+    readonly recovery: "The CPSC API is occasionally unavailable. Retry in a few seconds.";
+    readonly retryable: true;
+}], undefined>;
+//# sourceMappingURL=cpsc-get-recent.tool.d.ts.map

package/dist/mcp-server/tools/definitions/cpsc-get-recent.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpsc-get-recent.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/cpsc-get-recent.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAajE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmKxB,CAAC"}

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

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview Fetch the most recent CPSC recalls ordered newest-first, scoped to a
+ * configurable date window.
+ * @module mcp-server/tools/definitions/cpsc-get-recent
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCpscRecallService } from '../../../services/cpsc-recall/cpsc-recall-service.js';
+/** Static jurisdiction note included in every response. */
+const JURISDICTION = 'CPSC covers consumer products — toys, electronics, furniture, appliances, tools, clothing. ' +
+    'Does NOT cover: food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).';
+/** Format a Date as "YYYY-MM-DD". */
+function toIsoDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+export const cpscGetRecent = tool('cpsc_get_recent', {
+    title: 'Get Recent CPSC Recalls',
+    description: 'Fetch the most recent CPSC consumer product recalls, ordered newest-first. ' +
+        'Use for "what\'s been recalled lately?" or a product safety feed. ' +
+        'Always applies a date window (default: last 30 days) — without a date filter the API returns all 9,800+ records. ' +
+        'CPSC jurisdiction: consumer products only — food, vehicles, drugs, and pesticides are covered by other agencies.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        days: z
+            .number()
+            .int()
+            .min(1)
+            .max(365)
+            .default(30)
+            .describe('Look back this many days from today. Defaults to 30. Use 7 for a weekly digest, 90 for a quarterly review.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(20)
+            .describe('Maximum number of recalls to return. Defaults to 20.'),
+    }),
+    output: z.object({
+        recalls: z
+            .array(z
+            .object({
+            recall_number: z
+                .string()
+                .describe('Recall identifier. Pass to cpsc_get_recall for full detail.'),
+            recall_date: z.string().describe('Date issued, ISO 8601.'),
+            title: z.string().describe('Recall title.'),
+            hazards: z
+                .array(z.string().describe('Hazard description.'))
+                .describe('What is dangerous.'),
+            remedy_options: z.array(z.string().describe('Remedy type.')).describe('Remedy types.'),
+            products: z
+                .array(z.string().describe('Product name.'))
+                .describe('Product names recalled.'),
+            cpsc_url: z.string().describe('Official CPSC recall page URL.'),
+        })
+            .describe('A recent CPSC recall.'))
+            .describe('Recent recalls, newest-first.'),
+        period: z
+            .object({
+            start: z.string().describe('Start date of the query window, ISO 8601.'),
+            end: z.string().describe('End date (today), ISO 8601.'),
+            days: z.number().describe('Window length in days.'),
+        })
+            .describe('Date range queried.'),
+        total_found: z.number().describe('Total recalls in this period before the limit was applied.'),
+        truncated: z.boolean().describe('True when total_found exceeds the limit.'),
+        cpsc_jurisdiction: z
+            .string()
+            .describe('CPSC covers consumer products — toys, electronics, furniture, appliances, tools, clothing. ' +
+            'Does NOT cover: food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).'),
+    }),
+    errors: [
+        {
+            reason: 'upstream_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The saferproducts.gov API returned an error or timed out',
+            recovery: 'The CPSC API is occasionally unavailable. Retry in a few seconds.',
+            retryable: true,
+        },
+    ],
+    async handler(input, ctx) {
+        const endDate = new Date();
+        const startDate = new Date(endDate);
+        startDate.setDate(endDate.getDate() - input.days);
+        const dateStart = toIsoDate(startDate);
+        const dateEnd = toIsoDate(endDate);
+        ctx.log.info('Fetching recent CPSC recalls', {
+            days: input.days,
+            date_start: dateStart,
+            date_end: dateEnd,
+            limit: input.limit,
+        });
+        const svc = getCpscRecallService();
+        let raw;
+        try {
+            raw = await svc.getRecent(dateStart, dateEnd, ctx);
+        }
+        catch (err) {
+            throw ctx.fail('upstream_error', 'CPSC API request failed.', { ...ctx.recoveryFor('upstream_error') }, { cause: err });
+        }
+        const total_found = raw.length;
+        const slice = raw.slice(0, input.limit);
+        const truncated = total_found > input.limit;
+        const recalls = slice.map((r) => ({
+            recall_number: r.RecallNumber,
+            recall_date: r.RecallDate.slice(0, 10),
+            title: r.Title,
+            hazards: r.Hazards.map((h) => h.Name).filter(Boolean),
+            remedy_options: r.RemedyOptions.map((o) => o.Option).filter(Boolean),
+            products: r.Products.map((p) => p.Name).filter(Boolean),
+            cpsc_url: r.URL,
+        }));
+        ctx.log.info('Recent recalls fetched', { total_found, returned: recalls.length, truncated });
+        return {
+            recalls,
+            period: { start: dateStart, end: dateEnd, days: input.days },
+            total_found,
+            truncated,
+            cpsc_jurisdiction: JURISDICTION,
+        };
+    },
+    format(result) {
+        const lines = [];
+        lines.push(`# Recent CPSC Recalls — ${result.period.start} to ${result.period.end} (${result.period.days} days)`);
+        lines.push('');
+        const truncNote = result.truncated
+            ? `, showing first ${result.recalls.length} (truncated)`
+            : '';
+        lines.push(`Found ${result.total_found} recall${result.total_found !== 1 ? 's' : ''}${truncNote}.`);
+        lines.push('');
+        lines.push('---');
+        for (const r of result.recalls) {
+            const hazardText = r.hazards.length > 0 ? r.hazards.join('; ') : 'Not specified';
+            const remedyText = r.remedy_options.length > 0 ? r.remedy_options.join(', ') : 'Not specified';
+            const productText = r.products.length > 0 ? r.products.join(', ') : 'Not specified';
+            lines.push(`**${r.recall_date}** — [${r.recall_number}] ${r.title}`);
+            lines.push(`Hazard: ${hazardText}  |  Remedy: ${remedyText}`);
+            lines.push(`Products: ${productText}`);
+            lines.push(`[CPSC page](${r.cpsc_url})`);
+            lines.push('---');
+        }
+        lines.push(`CPSC jurisdiction: ${result.cpsc_jurisdiction}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=cpsc-get-recent.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/cpsc-search-recalls.tool.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Search CPSC consumer product recalls by product name, brand, retailer,
+ * hazard keyword, or date range.
+ * @module mcp-server/tools/definitions/cpsc-search-recalls
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const cpscSearchRecalls: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    product_name: z.ZodOptional<z.ZodString>;
+    manufacturer: z.ZodOptional<z.ZodString>;
+    retailer: z.ZodOptional<z.ZodString>;
+    importer: z.ZodOptional<z.ZodString>;
+    description_search: z.ZodOptional<z.ZodString>;
+    date_start: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>>;
+    date_end: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    recalls: z.ZodArray<z.ZodObject<{
+        recall_number: z.ZodString;
+        recall_date: z.ZodString;
+        title: z.ZodString;
+        hazards: z.ZodArray<z.ZodString>;
+        remedy_options: z.ZodArray<z.ZodString>;
+        remedy_summary: z.ZodString;
+        products: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            units_recalled: z.ZodString;
+        }, z.core.$strip>>;
+        upcs: z.ZodArray<z.ZodString>;
+        manufacturers: z.ZodArray<z.ZodString>;
+        importers: z.ZodArray<z.ZodString>;
+        retailers: z.ZodArray<z.ZodString>;
+        cpsc_url: z.ZodString;
+        images: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    total_found: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    cpsc_jurisdiction: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No recalls matched the search filters";
+    readonly recovery: "Broaden the search — try a shorter product name, fewer filters, or remove the date range. Check CPSC jurisdiction: food, vehicle, and drug recalls are not in this database.";
+}, {
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The saferproducts.gov API returned an error or timed out";
+    readonly recovery: "The CPSC API is occasionally unavailable. Retry in a few seconds.";
+    readonly retryable: true;
+}], undefined>;
+//# sourceMappingURL=cpsc-search-recalls.tool.d.ts.map

package/dist/mcp-server/tools/definitions/cpsc-search-recalls.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpsc-search-recalls.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/cpsc-search-recalls.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AASjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqS5B,CAAC"}