@cyanheads/federal-regulations-mcp-server 0.2.4 → 0.3.0

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

@@ -3,60 +3,61 @@
  * @module mcp-server/tools/definitions/index
  */
 export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    docket_id: import("zod").ZodString;
-    document_types: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
-        Notice: "Notice";
-        Other: "Other";
-        "Proposed Rule": "Proposed Rule";
-        Rule: "Rule";
-        "Supporting & Related Material": "Supporting & Related Material";
-    }>>>;
-    per_page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
-    page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+    document_number: import("zod").ZodString;
+    include_full_text: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    max_chars: import("zod").ZodOptional<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    docketId: import("zod").ZodString;
+    documentNumber: import("zod").ZodString;
     title: import("zod").ZodString;
-    docketType: import("zod").ZodNullable<import("zod").ZodString>;
-    agencyId: import("zod").ZodNullable<import("zod").ZodString>;
-    rin: import("zod").ZodNullable<import("zod").ZodString>;
+    type: import("zod").ZodString;
     abstract: import("zod").ZodNullable<import("zod").ZodString>;
-    modifyDate: import("zod").ZodNullable<import("zod").ZodString>;
-    objectId: import("zod").ZodNullable<import("zod").ZodString>;
-    documentCount: import("zod").ZodNumber;
-    documents: import("zod").ZodArray<import("zod").ZodObject<{
-        documentId: import("zod").ZodString;
-        objectId: import("zod").ZodString;
+    action: import("zod").ZodNullable<import("zod").ZodString>;
+    dates: import("zod").ZodNullable<import("zod").ZodString>;
+    publicationDate: import("zod").ZodString;
+    effectiveOn: import("zod").ZodNullable<import("zod").ZodString>;
+    commentsCloseOn: import("zod").ZodNullable<import("zod").ZodString>;
+    agencies: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        slug: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    regulationIdNumbers: import("zod").ZodArray<import("zod").ZodString>;
+    cfrReferences: import("zod").ZodArray<import("zod").ZodObject<{
+        title: import("zod").ZodNumber;
+        part: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    docketId: import("zod").ZodNullable<import("zod").ZodString>;
+    regulationsGovDocumentId: import("zod").ZodNullable<import("zod").ZodString>;
+    commentCount: import("zod").ZodNullable<import("zod").ZodNumber>;
+    supportingDocuments: import("zod").ZodArray<import("zod").ZodObject<{
         title: import("zod").ZodString;
-        documentType: import("zod").ZodString;
-        postedDate: import("zod").ZodString;
-        frDocNum: import("zod").ZodNullable<import("zod").ZodString>;
-        commentEndDate: import("zod").ZodNullable<import("zod").ZodString>;
-        withdrawn: import("zod").ZodBoolean;
+        documentId: import("zod").ZodString;
     }, import("zod/v4/core").$strip>>;
+    bodyHtmlUrl: import("zod").ZodString;
+    rawTextUrl: import("zod").ZodString;
+    htmlUrl: import("zod").ZodString;
+    fullText: import("zod").ZodOptional<import("zod").ZodString>;
+    fullTextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    fullTextLength: import("zod").ZodOptional<import("zod").ZodNumber>;
+    fullTextNextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "auth_required";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
-    readonly when: "REGULATIONS_GOV_API_KEY is not configured, or Regulations.gov rejected the key that is.";
-    readonly recovery: "Set the REGULATIONS_GOV_API_KEY env var to a working key (free at https://api.data.gov/signup/). The Federal Register and eCFR tools work without it.";
+    readonly reason: "full_text_disabled";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "offset or max_chars was passed together with include_full_text: false.";
+    readonly recovery: "Drop include_full_text: false to read the body window, or drop offset and max_chars to skip the body.";
 }, {
     readonly reason: "not_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No docket exists with that ID.";
-    readonly recovery: "Verify the docket ID from a Federal Register document's docketId; format is like \"EPA-HQ-OAR-2025-0194\".";
-}, {
-    readonly reason: "rate_limited";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
-    readonly when: "Regulations.gov returned 429 (1,000 requests/hour per key).";
-    readonly retryable: true;
-    readonly recovery: "Wait and retry — the per-key hourly limit was hit.";
+    readonly when: "No Federal Register document exists with that number.";
+    readonly recovery: "Verify the number via regulations_search_rules; FR numbers look like \"2025-14555\".";
+    readonly thrownBy: "service";
 }, {
     readonly reason: "upstream_unavailable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "Regulations.gov returned a 5xx, timed out, or could not be reached at all.";
-    readonly recovery: "Retry after a brief wait.";
+    readonly when: "Federal Register returned a 5xx, timed out, served an HTML error page, or failed to serve the body URL it published (include_full_text only).";
+    readonly recovery: "Retry after a brief wait; the Federal Register API may be momentarily down.";
+    readonly thrownBy: "service";
 }], {
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     query: import("zod").ZodOptional<import("zod").ZodString>;
@@ -69,6 +70,11 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     agencies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     published_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
     published_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    order: import("zod").ZodOptional<import("zod").ZodEnum<{
+        newest: "newest";
+        oldest: "oldest";
+        relevance: "relevance";
+    }>>;
     per_page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
     page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -78,7 +84,10 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         type: import("zod").ZodString;
         abstract: import("zod").ZodNullable<import("zod").ZodString>;
         publicationDate: import("zod").ZodString;
-        agencies: import("zod").ZodArray<import("zod").ZodString>;
+        agencies: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            slug: import("zod").ZodNullable<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
         docketIds: import("zod").ZodArray<import("zod").ZodString>;
         regulationIdNumbers: import("zod").ZodArray<import("zod").ZodString>;
         cfrReferences: import("zod").ZodArray<import("zod").ZodObject<{
@@ -94,52 +103,19 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "Federal Register returned a 5xx, timed out, or served an HTML error page.";
     readonly recovery: "Retry after a brief wait; the Federal Register API may be momentarily down.";
+}, {
+    readonly reason: "invalid_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The Federal Register rejected a filter value — most often an agency name or acronym passed where a slug belongs.";
+    readonly recovery: "Correct the parameter the message names: agencies takes Federal Register slugs in lowercase kebab-case (e.g. \"environmental-protection-agency\"; read one off agencies[].slug in a result), and dates must be real YYYY-MM-DD days.";
+    readonly severity: "notice";
+    readonly thrownBy: "service";
 }], {
     readonly totalCount: import("zod").ZodNumber;
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    document_number: import("zod").ZodString;
-    include_full_text: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    documentNumber: import("zod").ZodString;
-    title: import("zod").ZodString;
-    type: import("zod").ZodString;
-    abstract: import("zod").ZodNullable<import("zod").ZodString>;
-    action: import("zod").ZodNullable<import("zod").ZodString>;
-    dates: import("zod").ZodNullable<import("zod").ZodString>;
-    publicationDate: import("zod").ZodString;
-    effectiveOn: import("zod").ZodNullable<import("zod").ZodString>;
-    commentsCloseOn: import("zod").ZodNullable<import("zod").ZodString>;
-    agencies: import("zod").ZodArray<import("zod").ZodString>;
-    regulationIdNumbers: import("zod").ZodArray<import("zod").ZodString>;
-    cfrReferences: import("zod").ZodArray<import("zod").ZodObject<{
-        title: import("zod").ZodNumber;
-        part: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-    docketId: import("zod").ZodNullable<import("zod").ZodString>;
-    regulationsGovDocumentId: import("zod").ZodNullable<import("zod").ZodString>;
-    commentCount: import("zod").ZodNullable<import("zod").ZodNumber>;
-    supportingDocuments: import("zod").ZodArray<import("zod").ZodObject<{
-        title: import("zod").ZodString;
-        documentId: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-    bodyHtmlUrl: import("zod").ZodString;
-    rawTextUrl: import("zod").ZodString;
-    htmlUrl: import("zod").ZodString;
-    fullText: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No Federal Register document exists with that number.";
-    readonly recovery: "Verify the number via regulations_search_rules; FR numbers look like \"2025-14555\".";
-}, {
-    readonly reason: "upstream_unavailable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "Federal Register returned a 5xx, timed out, served an HTML error page, or failed to serve the body URL it published (include_full_text only).";
-    readonly recovery: "Retry after a brief wait; the Federal Register API may be momentarily down.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     mode: import("zod").ZodEnum<{
         search: "search";
         structure: "structure";
@@ -189,6 +165,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly when: "Structure mode where eCFR publishes no tree for the title at that date (a reserved title, or a date outside its coverage), or where the part is absent from the tree it does publish.";
     readonly recovery: "Omit part to list the whole title, or omit both to list every title; a reserved title and a date before ~2017 publish no tree at all.";
+    readonly thrownBy: "service";
 }, {
     readonly reason: "title_required_for_part";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
@@ -199,11 +176,13 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "Search mode with a date outside eCFR's indexed window (before 2017-01-03, or past its current index date).";
     readonly recovery: "Pick a date inside the window the error names, or omit date to search the current text.";
+    readonly thrownBy: "service";
 }, {
     readonly reason: "upstream_unavailable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "eCFR returned a 5xx, timed out, or served an HTML error page (live path).";
     readonly recovery: "Retry after a brief wait; the eCFR API may be momentarily down.";
+    readonly thrownBy: "service";
 }], {
     readonly totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -263,7 +242,67 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "eCFR returned a 5xx, timed out, or served an HTML error page (live path).";
     readonly recovery: "Retry after a brief wait; the eCFR API may be momentarily unavailable.";
+    readonly thrownBy: "service";
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    docket_id: import("zod").ZodString;
+    document_types: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        Notice: "Notice";
+        Other: "Other";
+        "Proposed Rule": "Proposed Rule";
+        Rule: "Rule";
+        "Supporting & Related Material": "Supporting & Related Material";
+    }>>>;
+    per_page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+    page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    docketId: import("zod").ZodString;
+    title: import("zod").ZodString;
+    docketType: import("zod").ZodNullable<import("zod").ZodString>;
+    agencyId: import("zod").ZodNullable<import("zod").ZodString>;
+    rin: import("zod").ZodNullable<import("zod").ZodString>;
+    abstract: import("zod").ZodNullable<import("zod").ZodString>;
+    modifyDate: import("zod").ZodNullable<import("zod").ZodString>;
+    objectId: import("zod").ZodNullable<import("zod").ZodString>;
+    documentCount: import("zod").ZodNumber;
+    documents: import("zod").ZodArray<import("zod").ZodObject<{
+        documentId: import("zod").ZodString;
+        objectId: import("zod").ZodString;
+        title: import("zod").ZodString;
+        documentType: import("zod").ZodString;
+        postedDate: import("zod").ZodString;
+        frDocNum: import("zod").ZodNullable<import("zod").ZodString>;
+        commentEndDate: import("zod").ZodNullable<import("zod").ZodString>;
+        withdrawn: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "auth_required";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
+    readonly when: "REGULATIONS_GOV_API_KEY is not configured, or Regulations.gov rejected the key that is.";
+    readonly recovery: "Set the REGULATIONS_GOV_API_KEY env var to a working key (free at https://api.data.gov/signup/). The Federal Register and eCFR tools work without it.";
+}, {
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No docket exists with that ID.";
+    readonly recovery: "Verify the docket ID from a Federal Register document's docketId; format is like \"EPA-HQ-OAR-2025-0194\".";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "Regulations.gov returned 429 (1,000 requests/hour per key).";
+    readonly retryable: true;
+    readonly recovery: "Wait and retry — the per-key hourly limit was hit.";
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "upstream_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Regulations.gov returned a 5xx, timed out, or could not be reached at all.";
+    readonly recovery: "Retry after a brief wait.";
+    readonly thrownBy: "service";
+}], {
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     docket_id: import("zod").ZodOptional<import("zod").ZodString>;
     document_object_id: import("zod").ZodOptional<import("zod").ZodString>;
     fr_document_number: import("zod").ZodOptional<import("zod").ZodString>;
@@ -331,11 +370,13 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly when: "Regulations.gov returned 429.";
     readonly retryable: true;
     readonly recovery: "Wait and retry — the per-key hourly limit (1,000/hr) was hit.";
+    readonly thrownBy: "service";
 }, {
     readonly reason: "upstream_unavailable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "Regulations.gov returned a 5xx, timed out, or could not be reached at all.";
     readonly recovery: "Retry after a brief wait.";
+    readonly thrownBy: "service";
 }], {
     readonly totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -343,6 +384,11 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     query: import("zod").ZodOptional<import("zod").ZodString>;
+    type: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        NOTICE: "NOTICE";
+        PRORULE: "PRORULE";
+        RULE: "RULE";
+    }>>>;
     agencies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     closing_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
     per_page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
@@ -354,7 +400,10 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         documentNumber: import("zod").ZodString;
         title: import("zod").ZodString;
         type: import("zod").ZodString;
-        agencies: import("zod").ZodArray<import("zod").ZodString>;
+        agencies: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            slug: import("zod").ZodNullable<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
         publicationDate: import("zod").ZodString;
         commentsCloseOn: import("zod").ZodString;
         daysRemaining: import("zod").ZodNumber;
@@ -366,10 +415,20 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "Federal Register returned a 5xx, timed out, or served an HTML error page.";
     readonly recovery: "Retry after a brief wait; the Federal Register API may be momentarily down.";
+}, {
+    readonly reason: "invalid_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The Federal Register rejected a filter value — most often an agency name or acronym passed where a slug belongs.";
+    readonly recovery: "Correct the parameter the message names: agencies takes Federal Register slugs in lowercase kebab-case (e.g. \"environmental-protection-agency\"; read one off agencies[].slug in a result), and closing_before must be a real YYYY-MM-DD day.";
+    readonly severity: "notice";
+    readonly thrownBy: "service";
 }], {
     readonly totalCount: import("zod").ZodNumber;
+    readonly totalPages: import("zod").ZodNumber;
+    readonly nextPage: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
 }>)[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAQ9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAQ9B,CAAC"}

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

@@ -1,15 +1,22 @@
 /**
- * @fileoverview regulations_list_open_comments — rules currently open for public
- * comment, filterable by agency and topic. "What can I still weigh in on?" Runs on
- * the Federal Register's open-comment window (keyless); the comment count is read
- * from each FR document's own embedded Regulations.gov info when a key is present.
- * Degrades gracefully — fully functional without the key.
+ * @fileoverview regulations_list_open_comments — documents currently open for
+ * public comment (proposed rules and comment-requesting final rules by default,
+ * notices on request), filterable by agency and topic. "What can I still weigh in
+ * on?" Runs on the Federal Register's open-comment window (keyless), fetched
+ * whole, sorted by closing date, and paged locally; the comment count is read
+ * from each FR document's own embedded Regulations.gov info when a key is
+ * present. Degrades gracefully — fully functional without the key.
  * @module mcp-server/tools/definitions/list-open-comments.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const listOpenCommentsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        NOTICE: "NOTICE";
+        PRORULE: "PRORULE";
+        RULE: "RULE";
+    }>>>;
     agencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
     closing_before: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>>;
     per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -21,7 +28,10 @@ export declare const listOpenCommentsTool: import("@cyanheads/mcp-ts-core").Tool
         documentNumber: z.ZodString;
         title: z.ZodString;
         type: z.ZodString;
-        agencies: z.ZodArray<z.ZodString>;
+        agencies: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            slug: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
         publicationDate: z.ZodString;
         commentsCloseOn: z.ZodString;
         daysRemaining: z.ZodNumber;
@@ -33,10 +43,20 @@ export declare const listOpenCommentsTool: import("@cyanheads/mcp-ts-core").Tool
     readonly code: JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "Federal Register returned a 5xx, timed out, or served an HTML error page.";
     readonly recovery: "Retry after a brief wait; the Federal Register API may be momentarily down.";
+}, {
+    readonly reason: "invalid_filter";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The Federal Register rejected a filter value — most often an agency name or acronym passed where a slug belongs.";
+    readonly recovery: "Correct the parameter the message names: agencies takes Federal Register slugs in lowercase kebab-case (e.g. \"environmental-protection-agency\"; read one off agencies[].slug in a result), and closing_before must be a real YYYY-MM-DD day.";
+    readonly severity: "notice";
+    readonly thrownBy: "service";
 }], {
     readonly totalCount: z.ZodNumber;
+    readonly totalPages: z.ZodNumber;
+    readonly nextPage: z.ZodOptional<z.ZodNumber>;
     readonly truncated: z.ZodOptional<z.ZodBoolean>;
     readonly shown: z.ZodOptional<z.ZodNumber>;
+    readonly cap: z.ZodOptional<z.ZodNumber>;
     readonly notice: z.ZodOptional<z.ZodString>;
 }>;
 //# sourceMappingURL=list-open-comments.tool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"list-open-comments.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-open-comments.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAgBjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsL/B,CAAC"}
+{"version":3,"file":"list-open-comments.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-open-comments.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsBjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+O/B,CAAC"}