@cyanheads/epa-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/search-violations.tool.js

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview Tool for searching EPA enforcement cases by location, program, or date range.
+ * @module mcp-server/tools/definitions/search-violations.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEchoService } from '../../../services/echo/echo-service.js';
+export const searchViolationsTool = tool('epa_search_violations', {
+    title: 'Search EPA Enforcement Cases',
+    description: "Search EPA civil and criminal enforcement cases by state, regulatory program, or date range. Returns case identifier, regulated facility name and Registry ID, programs involved, penalty assessed, settlement date, and case type. Designed for area-level violation discovery — for a single known facility's enforcement history use epa_get_facility instead. At least one of state or zip_code is required.",
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        state: z
+            .string()
+            .optional()
+            .describe('2-letter US state abbreviation to filter cases (e.g. "TX", "CA")'),
+        zip_code: z.string().optional().describe('5-digit ZIP code to filter cases near that area'),
+        program: z
+            .enum(['CAA', 'CWA', 'RCRA', 'SDWA', 'CERCLA', 'FIFRA', 'TSCA'])
+            .optional()
+            .describe('Filter by regulatory program: CAA=Clean Air Act, CWA=Clean Water Act, RCRA=hazardous waste, SDWA=drinking water, CERCLA=Superfund, FIFRA=pesticides, TSCA=toxic substances'),
+        case_type: z
+            .enum(['civil', 'criminal', 'all'])
+            .default('all')
+            .describe('Filter by case type: civil (regulatory violations), criminal (willful violations), or all'),
+        date_filed_start: z
+            .string()
+            .optional()
+            .describe('Start date for case filing date range (ISO 8601: YYYY-MM-DD)'),
+        date_filed_end: z
+            .string()
+            .optional()
+            .describe('End date for case filing date range (ISO 8601: YYYY-MM-DD)'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(50)
+            .describe('Maximum number of cases to return (1–100)'),
+    }),
+    output: z.object({
+        cases: z
+            .array(z
+            .object({
+            caseId: z.string().optional().describe('ECHO enforcement case identifier'),
+            caseName: z.string().optional().describe('Case name or docket number'),
+            facilityName: z.string().optional().describe('Regulated facility name'),
+            registryId: z
+                .string()
+                .optional()
+                .describe('EPA Registry ID — use with epa_get_facility for full compliance profile'),
+            programsViolated: z
+                .string()
+                .optional()
+                .describe('Regulatory programs cited in the case'),
+            caseType: z.string().optional().describe('Case type (civil or criminal)'),
+            penaltyAssessedInDollars: z
+                .number()
+                .optional()
+                .describe('Total penalty assessed in dollars'),
+            settlementDate: z.string().optional().describe('Settlement or resolution date'),
+            filedDate: z.string().optional().describe('Date the enforcement case was filed'),
+            state: z.string().optional().describe('State where the facility is located'),
+        })
+            .describe('EPA enforcement case record with facility, penalty, and program details'))
+            .describe('Matching enforcement cases'),
+        totalCount: z.number().describe('Total cases matched before the limit was applied'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no cases are found — echoes filters and suggests broadening. Absent when cases are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'no_geographic_filter',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither state nor zip_code was provided.',
+            recovery: 'Provide at least one of state or zip_code to scope the enforcement case search.',
+        },
+    ],
+    async handler(input, ctx) {
+        if (!input.state?.trim() && !input.zip_code?.trim()) {
+            throw ctx.fail('no_geographic_filter', 'At least one of state or zip_code is required to search enforcement cases.', {
+                ...ctx.recoveryFor('no_geographic_filter'),
+            });
+        }
+        ctx.log.info('epa_search_violations', {
+            state: input.state,
+            program: input.program,
+            caseType: input.case_type,
+        });
+        const state = input.state?.trim();
+        const zipCode = input.zip_code?.trim();
+        const dateFiledStart = input.date_filed_start?.trim();
+        const dateFiledEnd = input.date_filed_end?.trim();
+        const { cases, totalCount } = await getEchoService().searchViolations({
+            ...(state && { state }),
+            ...(zipCode && { zipCode }),
+            ...(input.program && { program: input.program }),
+            ...(input.case_type && { caseType: input.case_type }),
+            ...(dateFiledStart && { dateFiledStart }),
+            ...(dateFiledEnd && { dateFiledEnd }),
+            limit: input.limit,
+        }, ctx);
+        ctx.log.info('epa_search_violations completed', { count: cases.length, totalCount });
+        if (cases.length === 0) {
+            const parts = [];
+            if (input.state)
+                parts.push(`state="${input.state}"`);
+            if (input.zip_code)
+                parts.push(`zip_code="${input.zip_code}"`);
+            if (input.program)
+                parts.push(`program="${input.program}"`);
+            if (input.case_type && input.case_type !== 'all')
+                parts.push(`case_type="${input.case_type}"`);
+            return {
+                cases: [],
+                totalCount: 0,
+                message: `No enforcement cases matched: ${parts.join(', ')}. Try removing program or date filters, or expanding the geographic area.`,
+            };
+        }
+        return { cases, totalCount };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## EPA Enforcement Cases`);
+        lines.push(`**Total Found:** ${result.totalCount} | **Returned:** ${result.cases.length}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const c of result.cases) {
+            lines.push(`\n### ${c.caseName ?? c.caseId ?? 'Unnamed Case'}`);
+            if (c.caseId)
+                lines.push(`**Case ID:** ${c.caseId}`);
+            if (c.facilityName)
+                lines.push(`**Facility:** ${c.facilityName}`);
+            if (c.registryId)
+                lines.push(`**Registry ID:** ${c.registryId}`);
+            if (c.state)
+                lines.push(`**State:** ${c.state}`);
+            if (c.programsViolated)
+                lines.push(`**Programs:** ${c.programsViolated}`);
+            if (c.caseType)
+                lines.push(`**Type:** ${c.caseType}`);
+            if (c.penaltyAssessedInDollars !== undefined) {
+                lines.push(`**Penalty:** $${c.penaltyAssessedInDollars.toLocaleString()}`);
+            }
+            if (c.filedDate)
+                lines.push(`**Filed:** ${c.filedDate}`);
+            if (c.settlementDate)
+                lines.push(`**Settlement:** ${c.settlementDate}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-violations.tool.js.map

package/dist/mcp-server/tools/definitions/search-violations.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-water-systems.tool.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Tool for searching drinking water systems (SDWIS) by state or ZIP code.
+ * @module mcp-server/tools/definitions/search-water-systems.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchWaterSystemsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    state: z.ZodOptional<z.ZodString>;
+    zip_code: z.ZodOptional<z.ZodString>;
+    has_violation: z.ZodOptional<z.ZodBoolean>;
+    pws_type: z.ZodOptional<z.ZodEnum<{
+        community: "community";
+        "non-transient": "non-transient";
+        transient: "transient";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    systems: z.ZodArray<z.ZodObject<{
+        pwsid: z.ZodString;
+        name: z.ZodString;
+        state: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        zip: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        populationServed: z.ZodOptional<z.ZodNumber>;
+        primarySourceCode: z.ZodOptional<z.ZodString>;
+        hasViolation: z.ZodOptional<z.ZodBoolean>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_geographic_filter";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither state nor zip_code was provided.";
+    readonly recovery: "Provide at least one of state or zip_code to search drinking water systems.";
+}]>;
+//# sourceMappingURL=search-water-systems.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-water-systems.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-water-systems.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-water-systems.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyJjC,CAAC"}

package/dist/mcp-server/tools/definitions/search-water-systems.tool.js

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview Tool for searching drinking water systems (SDWIS) by state or ZIP code.
+ * @module mcp-server/tools/definitions/search-water-systems.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getDmapService } from '../../../services/dmap/dmap-service.js';
+export const searchWaterSystemsTool = tool('epa_search_water_systems', {
+    title: 'Search Drinking Water Systems',
+    description: 'Search drinking water systems (SDWIS) by state or ZIP code. Returns system name, PWSID, population served, primary water source, and active violation status. Use to identify community water systems with current or recent compliance violations. At least one of state or zip_code is required.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        state: z.string().optional().describe('2-letter US state abbreviation (e.g. "WA", "CA")'),
+        zip_code: z.string().optional().describe('5-digit ZIP code to search within'),
+        has_violation: z
+            .boolean()
+            .optional()
+            .describe('When true, return only systems with active violations'),
+        pws_type: z
+            .enum(['community', 'non-transient', 'transient'])
+            .optional()
+            .describe('Filter by public water system type: community=permanent residences, non-transient=regular non-residents (schools, businesses), transient=occasional users (campgrounds)'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(50)
+            .describe('Maximum number of systems to return (1–200)'),
+    }),
+    output: z.object({
+        systems: z
+            .array(z
+            .object({
+            pwsid: z.string().describe('Public Water System ID (PWSID) — unique system identifier'),
+            name: z.string().describe('Water system name'),
+            state: z
+                .string()
+                .optional()
+                .describe('2-letter state abbreviation (primacy agency code)'),
+            city: z.string().optional().describe('City served by this water system'),
+            zip: z.string().optional().describe('ZIP code'),
+            type: z
+                .string()
+                .optional()
+                .describe('PWS type code: CWS=Community, NTNCWS=Non-transient non-community, TNCWS=Transient non-community'),
+            populationServed: z
+                .number()
+                .optional()
+                .describe('Estimated population served by this water system'),
+            primarySourceCode: z
+                .string()
+                .optional()
+                .describe('Primary water source code (e.g. GW=groundwater, SW=surface water)'),
+            hasViolation: z
+                .boolean()
+                .optional()
+                .describe('Whether this system has an active compliance violation on record'),
+            isActive: z
+                .boolean()
+                .optional()
+                .describe('Whether this water system is currently active'),
+        })
+            .describe('Public water system record with PWSID, population served, and violation status'))
+            .describe('Matching public water systems'),
+        totalCount: z.number().describe('Number of systems returned'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no systems are found. Absent when systems are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'no_geographic_filter',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither state nor zip_code was provided.',
+            recovery: 'Provide at least one of state or zip_code to search drinking water systems.',
+        },
+    ],
+    async handler(input, ctx) {
+        if (!input.state?.trim() && !input.zip_code?.trim()) {
+            throw ctx.fail('no_geographic_filter', 'At least one of state or zip_code is required.', {
+                ...ctx.recoveryFor('no_geographic_filter'),
+            });
+        }
+        ctx.log.info('epa_search_water_systems', {
+            state: input.state,
+            zip: input.zip_code,
+            hasViolation: input.has_violation,
+            type: input.pws_type,
+        });
+        const state = input.state?.trim();
+        const zipCode = input.zip_code?.trim();
+        const systems = await getDmapService().searchWaterSystems({
+            ...(state && { state }),
+            ...(zipCode && { zipCode }),
+            ...(input.has_violation && { hasViolation: input.has_violation }),
+            ...(input.pws_type && { pwsType: input.pws_type }),
+            limit: input.limit,
+        }, ctx);
+        ctx.log.info('epa_search_water_systems completed', { count: systems.length });
+        if (systems.length === 0) {
+            const parts = [];
+            if (input.state)
+                parts.push(`state="${input.state}"`);
+            if (input.zip_code)
+                parts.push(`zip_code="${input.zip_code}"`);
+            if (input.has_violation)
+                parts.push('has_violation=true');
+            if (input.pws_type)
+                parts.push(`pws_type="${input.pws_type}"`);
+            return {
+                systems: [],
+                totalCount: 0,
+                message: `No water systems found matching: ${parts.join(', ')}. Try removing the violation or type filter, or checking the state abbreviation.`,
+            };
+        }
+        return { systems, totalCount: systems.length };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## Drinking Water Systems`);
+        lines.push(`**Found:** ${result.totalCount}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const s of result.systems) {
+            const violationFlag = s.hasViolation === true ? ' ⚠️ VIOLATION' : '';
+            lines.push(`\n### ${s.name}${violationFlag}`);
+            lines.push(`**PWSID:** ${s.pwsid}`);
+            const location = [s.city, s.state, s.zip].filter(Boolean).join(', ');
+            if (location)
+                lines.push(`**Location:** ${location}`);
+            if (s.type)
+                lines.push(`**Type:** ${s.type}`);
+            if (s.populationServed !== undefined)
+                lines.push(`**Population Served:** ${s.populationServed.toLocaleString()}`);
+            if (s.primarySourceCode)
+                lines.push(`**Primary Source:** ${s.primarySourceCode}`);
+            if (s.hasViolation !== undefined)
+                lines.push(`**Active Violation:** ${s.hasViolation ? 'Yes' : 'No'}`);
+            if (s.isActive !== undefined)
+                lines.push(`**Active:** ${s.isActive ? 'Yes' : 'No'}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-water-systems.tool.js.map

package/dist/mcp-server/tools/definitions/search-water-systems.tool.js.map

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

package/dist/services/airnow/airnow-service.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview AirNow API service for real-time and forecast air quality data.
+ * Wraps www.airnowapi.org/aq endpoints. Responses cached at ~1 hour TTL per the
+ * AirNow API's recommendation to avoid rate-limiting.
+ * @module services/airnow/airnow-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { AirQualityResult } from './types.js';
+export declare class AirNowService {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(_config: AppConfig, _storage: StorageService);
+    private buildUrl;
+    private cacheKey;
+    private fetchWithCache;
+    /** Get current air quality by ZIP code. */
+    getCurrentByZip(params: {
+        zipCode: string;
+        distanceMiles?: number;
+    }, ctx: Context): Promise<AirQualityResult[]>;
+    /** Get current air quality by lat/lng. */
+    getCurrentByLatLng(params: {
+        latitude: number;
+        longitude: number;
+        distanceMiles?: number;
+    }, ctx: Context): Promise<AirQualityResult[]>;
+    /** Get air quality forecast by ZIP code. */
+    getForecastByZip(params: {
+        zipCode: string;
+        date: string;
+        distanceMiles?: number;
+    }, ctx: Context): Promise<AirQualityResult[]>;
+    /** Get air quality forecast by lat/lng. */
+    getForecastByLatLng(params: {
+        latitude: number;
+        longitude: number;
+        date: string;
+        distanceMiles?: number;
+    }, ctx: Context): Promise<AirQualityResult[]>;
+}
+export declare function initAirNowService(config: AppConfig, storage: StorageService): void;
+export declare function getAirNowService(): AirNowService;
+//# sourceMappingURL=airnow-service.d.ts.map

package/dist/services/airnow/airnow-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"airnow-service.d.ts","sourceRoot":"","sources":["../../../src/services/airnow/airnow-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAC;AAqCpE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc;IAMxD,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,QAAQ;YASF,cAAc;IAwC5B,2CAA2C;IACrC,eAAe,CACnB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAS9B,0CAA0C;IACpC,kBAAkB,CACtB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAa9B,4CAA4C;IACtC,gBAAgB,CACpB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAa9B,2CAA2C;IACrC,mBAAmB,CACvB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAiB/B;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAElF;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD"}

package/dist/services/airnow/airnow-service.js

@@ -0,0 +1,160 @@
+/**
+ * @fileoverview AirNow API service for real-time and forecast air quality data.
+ * Wraps www.airnowapi.org/aq endpoints. Responses cached at ~1 hour TTL per the
+ * AirNow API's recommendation to avoid rate-limiting.
+ * @module services/airnow/airnow-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { httpErrorFromResponse, withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+/** Normalize raw AirNow records (grouped by reporting area) into AirQualityResult[]. */
+function normalizeRecords(records) {
+    // Group by reporting area + date/hour
+    const grouped = new Map();
+    for (const r of records) {
+        const key = `${r.ReportingArea ?? ''}|${r.DateObserved ?? ''}|${r.HourObserved ?? ''}`;
+        if (!grouped.has(key)) {
+            grouped.set(key, {
+                ...(r.ReportingArea && { reportingArea: r.ReportingArea.trim() }),
+                ...(r.StateCode && { stateCode: r.StateCode }),
+                ...(r.Latitude !== undefined && { latitude: r.Latitude }),
+                ...(r.Longitude !== undefined && { longitude: r.Longitude }),
+                ...(r.DateObserved && { dateObserved: r.DateObserved.trim() }),
+                ...(r.HourObserved !== undefined && { hourObserved: r.HourObserved }),
+                ...(r.LocalTimeZone && { localTimeZone: r.LocalTimeZone }),
+                readings: [],
+            });
+        }
+        const entry = grouped.get(key);
+        if (r.ParameterName && r.AQI !== undefined) {
+            entry.readings.push({
+                parameterName: r.ParameterName,
+                aqi: r.AQI,
+                ...(r.Category?.Number !== undefined && { categoryNumber: r.Category.Number }),
+                ...(r.Category?.Name && { categoryName: r.Category.Name }),
+            });
+        }
+    }
+    return Array.from(grouped.values());
+}
+export class AirNowService {
+    baseUrl;
+    apiKey;
+    constructor(_config, _storage) {
+        const serverConfig = getServerConfig();
+        this.baseUrl = serverConfig.airNowBaseUrl;
+        this.apiKey = serverConfig.airNowApiKey;
+    }
+    buildUrl(path, params) {
+        const url = new URL(`${this.baseUrl}/${path}`);
+        url.searchParams.set('format', 'application/json');
+        url.searchParams.set('API_KEY', this.apiKey);
+        for (const [key, val] of Object.entries(params)) {
+            if (val !== undefined && val !== '') {
+                url.searchParams.set(key, String(val));
+            }
+        }
+        return url.toString();
+    }
+    cacheKey(kind, params) {
+        const stable = Object.entries(params)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${k}-${v}`)
+            .join('_');
+        return `airnow:${kind}:${stable}`;
+    }
+    async fetchWithCache(url, cacheKey, ctx) {
+        // Try cache first
+        const cached = await ctx.state.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            ctx.log.debug('AirNow cache hit', { cacheKey });
+            return cached.data;
+        }
+        const data = await withRetry(async () => {
+            const response = await fetch(url, { signal: ctx.signal });
+            if (!response.ok) {
+                throw await httpErrorFromResponse(response, { service: 'AirNow', data: { url } });
+            }
+            const text = await response.text();
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('AirNow API returned HTML instead of JSON — likely rate-limited.', { url });
+            }
+            const parsed = JSON.parse(text);
+            return Array.isArray(parsed) ? parsed : [];
+        }, {
+            operation: 'AirNowService.fetch',
+            baseDelayMs: 2000,
+            signal: ctx.signal,
+        });
+        // Store in cache
+        await ctx.state.set(cacheKey, { data, expiresAt: Date.now() + CACHE_TTL_MS });
+        return data;
+    }
+    /** Get current air quality by ZIP code. */
+    async getCurrentByZip(params, ctx) {
+        const qparams = { zipCode: params.zipCode, distance: params.distanceMiles ?? 25 };
+        const url = this.buildUrl('observation/zipCode/current/', qparams);
+        const ck = this.cacheKey('current:zip', qparams);
+        ctx.log.debug('AirNow current by ZIP', { zipCode: params.zipCode });
+        const records = await this.fetchWithCache(url, ck, ctx);
+        return normalizeRecords(records);
+    }
+    /** Get current air quality by lat/lng. */
+    async getCurrentByLatLng(params, ctx) {
+        const qparams = {
+            latitude: params.latitude,
+            longitude: params.longitude,
+            distance: params.distanceMiles ?? 25,
+        };
+        const url = this.buildUrl('observation/latLong/current/', qparams);
+        const ck = this.cacheKey('current:latlng', qparams);
+        ctx.log.debug('AirNow current by lat/lng', { lat: params.latitude, lng: params.longitude });
+        const records = await this.fetchWithCache(url, ck, ctx);
+        return normalizeRecords(records);
+    }
+    /** Get air quality forecast by ZIP code. */
+    async getForecastByZip(params, ctx) {
+        const qparams = {
+            zipCode: params.zipCode,
+            date: params.date,
+            distance: params.distanceMiles ?? 25,
+        };
+        const url = this.buildUrl('forecast/zipCode/', qparams);
+        const ck = this.cacheKey('forecast:zip', qparams);
+        ctx.log.debug('AirNow forecast by ZIP', { zipCode: params.zipCode, date: params.date });
+        const records = await this.fetchWithCache(url, ck, ctx);
+        return normalizeRecords(records);
+    }
+    /** Get air quality forecast by lat/lng. */
+    async getForecastByLatLng(params, ctx) {
+        const qparams = {
+            latitude: params.latitude,
+            longitude: params.longitude,
+            date: params.date,
+            distance: params.distanceMiles ?? 25,
+        };
+        const url = this.buildUrl('forecast/latLong/', qparams);
+        const ck = this.cacheKey('forecast:latlng', qparams);
+        ctx.log.debug('AirNow forecast by lat/lng', {
+            lat: params.latitude,
+            lng: params.longitude,
+            date: params.date,
+        });
+        const records = await this.fetchWithCache(url, ck, ctx);
+        return normalizeRecords(records);
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initAirNowService(config, storage) {
+    _service = new AirNowService(config, storage);
+}
+export function getAirNowService() {
+    if (!_service) {
+        throw new Error('AirNowService not initialized — call initAirNowService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=airnow-service.js.map

package/dist/services/airnow/airnow-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"airnow-service.js","sourceRoot":"","sources":["../../../src/services/airnow/airnow-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAE9C,wFAAwF;AACxF,SAAS,gBAAgB,CAAC,OAA0B;IAClD,sCAAsC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEpD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,aAAa,IAAI,EAAE,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QACvF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;gBACf,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;gBACjE,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC9C,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACzD,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC5D,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9D,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;gBACrE,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;gBAC1D,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAChC,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3C,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAClB,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC9E,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,OAAO,aAAa;IACP,OAAO,CAAS;IAChB,MAAM,CAAS;IAEhC,YAAY,OAAkB,EAAE,QAAwB;QACtD,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC;IAC1C,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,MAAmD;QAChF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,MAAmD;QAChF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;aAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,UAAU,IAAI,IAAI,MAAM,EAAE,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,GAAW,EACX,QAAgB,EAChB,GAAY;QAEZ,kBAAkB;QAClB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAiD,QAAQ,CAAC,CAAC;QAC7F,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC5C,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,SAAS,CAC1B,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,qBAAqB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,MAAM,kBAAkB,CACtB,iEAAiE,EACjE,EAAE,GAAG,EAAE,CACR,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAA4B,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,CAAC,EACD;YACE,SAAS,EAAE,qBAAqB;YAChC,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CACF,CAAC;QAEF,iBAAiB;QACjB,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,eAAe,CACnB,MAGC,EACD,GAAY;QAEZ,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAClF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,kBAAkB,CACtB,MAIC,EACD,GAAY;QAEZ,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;SACrC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,gBAAgB,CACpB,MAIC,EACD,GAAY;QAEZ,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;SACrC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,mBAAmB,CACvB,MAKC,EACD,GAAY;QAEZ,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;SACrC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE;YAC1C,GAAG,EAAE,MAAM,CAAC,QAAQ;YACpB,GAAG,EAAE,MAAM,CAAC,SAAS;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACF;AAED,gCAAgC;AAEhC,IAAI,QAAmC,CAAC;AAExC,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAuB;IAC1E,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/services/airnow/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview AirNow API response types and normalized domain types.
+ * @module services/airnow/types
+ */
+/** Raw AirNow observation/forecast record from the JSON API. */
+export interface RawAirNowRecord {
+    AQI?: number;
+    Category?: {
+        Number?: number;
+        Name?: string;
+    };
+    DateObserved?: string;
+    HourObserved?: number;
+    Latitude?: number;
+    LocalTimeZone?: string;
+    Longitude?: number;
+    ParameterName?: string;
+    ReportingArea?: string;
+    StateCode?: string;
+}
+/** Normalized AQI reading for a single pollutant. */
+export interface AqiReading {
+    aqi: number;
+    categoryName?: string;
+    categoryNumber?: number;
+    parameterName: string;
+}
+/** Normalized AirNow observation/forecast result. */
+export interface AirQualityResult {
+    dateObserved?: string;
+    hourObserved?: number;
+    latitude?: number;
+    localTimeZone?: string;
+    longitude?: number;
+    readings: AqiReading[];
+    reportingArea?: string;
+    stateCode?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/airnow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/airnow/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/services/airnow/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview AirNow API response types and normalized domain types.
+ * @module services/airnow/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/airnow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/airnow/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}