@cyanheads/epa-mcp-server 0.4.0 → 0.4.1

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

@@ -8,16 +8,26 @@ 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 { EpaCase, EpaFacility, EpaFacilityProfile } from './types.js';
+/** Programs a facility search filters on. */
+export type FacilityProgram = 'CAA' | 'CWA' | 'RCRA' | 'TRI' | 'SDWA';
+/** Enforcement case types a case search filters on. */
+export type CaseType = 'civil' | 'criminal' | 'all';
 export declare class EchoService {
     private readonly baseUrl;
-    constructor(_config: AppConfig, _storage: StorageService);
+    private readonly userAgent;
+    constructor(config: AppConfig, _storage: StorageService);
     /** Build URL with query params. */
     private buildUrl;
-    /** Fetch JSON from ECHO with retry. */
+    /**
+     * Fetch JSON from ECHO with retry. `retry.deadlineMs` bounds every attempt and backoff and is
+     * required, so no ECHO request runs without a share of its tool call's budget; `maxRetries`
+     * narrows the attempt count.
+     */
     private fetchJson;
     /**
-     * Search EPA-regulated facilities using ECHO get_facility_info.
-     * At least one geographic parameter must be supplied.
+     * Search EPA-regulated facilities using ECHO get_facility_info, then get_qid for the first
+     * page when ECHO does not return the rows inline. At least one geographic parameter must be
+     * supplied.
      */
     searchFacilities(params: {
         zipCode?: string;
@@ -27,7 +37,7 @@ export declare class EchoService {
         longitude?: number;
         radiusMiles?: number;
         activeOnly?: boolean;
-        programs?: string[];
+        program?: FacilityProgram;
         hasViolation?: boolean;
         limit?: number;
     }, ctx: Context): Promise<{
@@ -35,14 +45,26 @@ export declare class EchoService {
         totalCount: number;
     }>;
     /**
-     * Retrieve a full compliance profile for a single facility, aggregating multiple DFR endpoints.
+     * Retrieve a full compliance profile for a single facility from one
+     * dfr_rest_services.get_dfr response, plus a best-effort facility search row for the
+     * facility-level compliance status that no DFR section carries.
      *
-     * Step 1 uses dfr_rest_services.get_dfr (accepts Registry IDs directly) to obtain base facility
-     * data. The previous approach used echo_rest_services.get_facility_info?p_id=registryId, which
-     * only accepts program-specific IDs (e.g. RCRA handler IDs), never numeric Registry IDs — so it
-     * always returned 0 results. Steps 2-5 run in parallel after the initial DFR fetch.
+     * get_dfr takes a Registry ID or a program ID (a TRI or RCRA ID resolves to its Registry ID);
+     * echo_rest_services.get_facility_info takes the resolved Registry ID only as `p_frs`.
+     * A failed status lookup is disclosed as an enrichment notice.
      */
     getFacility(registryId: string, ctx: Context): Promise<EpaFacilityProfile>;
+    /** The getFacility profile, with the notice to show when the status lookup failed. */
+    getFacilityReport(registryId: string, ctx: Context): Promise<{
+        profile: EpaFacilityProfile;
+        notice?: string;
+    }>;
+    /**
+     * Best-effort echo_rest_services.get_facility_info?p_frs row, the only source of ECHO's
+     * facility-level compliance status. Two attempts within what is left of the call's budget;
+     * any failure but caller cancellation returns `failed` instead of throwing.
+     */
+    private fetchFacilityStatusRow;
     /**
      * Search EPA enforcement cases using a two-step ECHO case_rest_services flow.
      *
@@ -51,12 +73,17 @@ export declare class EchoService {
      *
      * The single-step approach (reading Cases from get_case_info) always returns empty because
      * get_case_info is a discovery/cluster endpoint that does not include paginated case records.
+     *
+     * Filing dates are validated YYYY-MM-DD strings. A date bound sends both MM/DD/YYYY ends ECHO
+     * requires — an open end reads 01/01/1900 or today (UTC), and each end is clamped to that span —
+     * with the civil filing milestones. A range that clamps empty returns no cases without a
+     * request: ECHO answers an inverted range with an in-band error, not an empty result.
      */
     searchViolations(params: {
         state?: string;
         zipCode?: string;
         program?: string;
-        caseType?: string;
+        caseType?: CaseType;
         dateFiledStart?: string;
         dateFiledEnd?: string;
         limit?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"echo-service.d.ts","sourceRoot":"","sources":["../../../src/services/echo/echo-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,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EASnB,MAAM,YAAY,CAAC;AA0CpB,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAGjC,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAEvD;IAED,mCAAmC;IACnC,OAAO,CAAC,QAAQ;IAahB,uCAAuC;YAEzB,SAAS;IAiCvB;;;OAGG;IACG,gBAAgB,CACpB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,UAAU,EAAE,WAAW,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAqE5D;IAED;;;;;;;OAOG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiJ/E;IAED;;;;;;;;OAQG;IACG,gBAAgB,CACpB,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CA8DnD;CACF;AAMD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAEhF;AAED,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}
+{"version":3,"file":"echo-service.d.ts","sourceRoot":"","sources":["../../../src/services/echo/echo-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;AAO/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAWnB,MAAM,YAAY,CAAC;AA4BpB,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AActE,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;AA+MpD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAGnC,YAAY,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAGtD;IAED,mCAAmC;IACnC,OAAO,CAAC,QAAQ;IAahB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAmCjB;;;;OAIG;IACG,gBAAgB,CACpB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,eAAe,CAAC;QAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,UAAU,EAAE,WAAW,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAgE5D;IAED;;;;;;;;OAQG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAI/E;IAED,sFAAsF;IAChF,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAkK3D;IAED;;;;OAIG;YACW,sBAAsB;IA6BpC;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CACpB,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAiFnD;CACF;AAMD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAEhF;AAED,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}