@cyanheads/secedgar-mcp-server 0.15.13 → 0.15.15

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

@@ -25,49 +25,384 @@ export interface ToolDefinitionOptions {
  * it is present, so the manifest's tool count matches the documented surface.
  */
 export declare function buildToolDefinitions(options: ToolDefinitionOptions): (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    query: import("zod").ZodString;
-    include_filings: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    filing_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-    filed_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
-    filed_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    companies: import("zod").ZodArray<import("zod").ZodString>;
+    concepts: import("zod").ZodArray<import("zod").ZodString>;
+    taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
+        "ifrs-full": "ifrs-full";
+        "us-gaap": "us-gaap";
+    }>>;
+    period_type: import("zod").ZodDefault<import("zod").ZodEnum<{
+        annual: "annual";
+        quarterly: "quarterly";
+    }>>;
+    periods: import("zod").ZodDefault<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    cik: import("zod").ZodString;
-    name: import("zod").ZodString;
-    tickers: import("zod").ZodArray<import("zod").ZodString>;
-    exchanges: import("zod").ZodArray<import("zod").ZodString>;
-    sic: import("zod").ZodString;
-    sic_description: import("zod").ZodString;
-    state_of_incorporation: import("zod").ZodOptional<import("zod").ZodString>;
-    fiscal_year_end: import("zod").ZodOptional<import("zod").ZodString>;
-    series_id: import("zod").ZodOptional<import("zod").ZodString>;
-    class_id: import("zod").ZodOptional<import("zod").ZodString>;
-    filings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+    period_type: import("zod").ZodString;
+    taxonomy: import("zod").ZodString;
+    periods: import("zod").ZodArray<import("zod").ZodString>;
+    companies: import("zod").ZodArray<import("zod").ZodObject<{
+        input: import("zod").ZodString;
+        cik: import("zod").ZodString;
+        name: import("zod").ZodString;
+        ticker: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    failed_companies: import("zod").ZodArray<import("zod").ZodObject<{
+        input: import("zod").ZodString;
+        reason: import("zod").ZodEnum<{
+            ambiguous: "ambiguous";
+            no_company_facts: "no_company_facts";
+            not_found: "not_found";
+        }>;
+        message: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    concepts: import("zod").ZodArray<import("zod").ZodObject<{
+        concept: import("zod").ZodString;
+        label: import("zod").ZodString;
+        units: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    cells: import("zod").ZodArray<import("zod").ZodObject<{
+        cik: import("zod").ZodString;
+        company: import("zod").ZodString;
+        concept: import("zod").ZodString;
+        period: import("zod").ZodString;
+        value: import("zod").ZodNumber;
+        unit: import("zod").ZodString;
+        taxonomy: import("zod").ZodString;
+        tag: import("zod").ZodString;
+        frame: import("zod").ZodString;
+        period_end: import("zod").ZodString;
+        form: import("zod").ZodString;
+        accession_number: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    gaps: import("zod").ZodArray<import("zod").ZodObject<{
+        cik: import("zod").ZodString;
+        company: import("zod").ZodString;
+        concept: import("zod").ZodString;
+        tags_tried: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    unknown_concepts: import("zod").ZodArray<import("zod").ZodObject<{
+        concept: import("zod").ZodString;
+        derivation: import("zod").ZodOptional<import("zod").ZodString>;
+        suggestions: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    caveats: import("zod").ZodArray<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        row_count: import("zod").ZodNumber;
+        expires_at: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_companies_resolved";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "None of the supplied company inputs resolved to a CIK";
+    readonly recovery: "Use ticker symbols or 10-digit CIK numbers for exact matches.";
+}, {
+    readonly reason: "no_comparable_data";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Companies resolved but not one of them reports any of the requested concepts for the requested period type";
+    readonly recovery: "Switch period_type, or discover reported concept names with secedgar_search_concepts.";
+}, {
+    readonly reason: "unknown_concept";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Every requested concept is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
+    readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
+    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "sec_unreachable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    concept: import("zod").ZodString;
+    taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
+        dei: "dei";
+        "us-gaap": "us-gaap";
+    }>>;
+    period: import("zod").ZodString;
+    unit: import("zod").ZodDefault<import("zod").ZodEnum<{
+        USD: "USD";
+        "USD-per-shares": "USD-per-shares";
+        "USD/shares": "USD/shares";
+        pure: "pure";
+        shares: "shares";
+    }>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+    sort: import("zod").ZodDefault<import("zod").ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    concept: import("zod").ZodString;
+    taxonomy: import("zod").ZodString;
+    period: import("zod").ZodString;
+    unit: import("zod").ZodString;
+    label: import("zod").ZodString;
+    total_companies: import("zod").ZodNumber;
+    offset: import("zod").ZodNumber;
+    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    data: import("zod").ZodArray<import("zod").ZodObject<{
+        rank: import("zod").ZodNumber;
+        company_name: import("zod").ZodString;
+        cik: import("zod").ZodString;
+        ticker: import("zod").ZodOptional<import("zod").ZodString>;
+        value: import("zod").ZodNumber;
+        location: import("zod").ZodOptional<import("zod").ZodString>;
+        period_end: import("zod").ZodString;
+        accession_number: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        row_count: import("zod").ZodNumber;
+        expires_at: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    unqueried_tags: import("zod").ZodArray<import("zod").ZodString>;
+    related_tags: import("zod").ZodArray<import("zod").ZodObject<{
+        tag: import("zod").ZodString;
+        note: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    value_distribution: import("zod").ZodObject<{
+        median: import("zod").ZodNumber;
+        p95: import("zod").ZodNumber;
+        max: import("zod").ZodNumber;
+        max_to_p95_ratio: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>;
+    period_end_range: import("zod").ZodObject<{
+        min: import("zod").ZodString;
+        max: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    caveats: import("zod").ZodArray<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "unknown_concept";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
+    readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
+}, {
+    readonly reason: "no_data";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Concept resolves but no companies report this metric for the requested period and unit";
+    readonly recovery: "Check duration vs instant period, unit, and that the period exists post-CY2009.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
+    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "sec_unreachable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    issuer: import("zod").ZodString;
+    form_kind: import("zod").ZodDefault<import("zod").ZodEnum<{
+        "13D": "13D";
+        "13G": "13G";
+        all: "all";
+    }>>;
+    include_amendments: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    issuer: import("zod").ZodString;
+    issuer_cik: import("zod").ZodString;
+    issuer_name: import("zod").ZodString;
+    form_kind: import("zod").ZodEnum<{
+        "13D": "13D";
+        "13G": "13G";
+        all: "all";
+    }>;
+    total_structured_filings: import("zod").ZodNumber;
+    filings_parsed: import("zod").ZodNumber;
+    filings_examined: import("zod").ZodNumber;
+    filings_excluded_other_issuer: import("zod").ZodNumber;
+    filings_not_examined: import("zod").ZodNumber;
+    filings_failed: import("zod").ZodArray<import("zod").ZodObject<{
         accession_number: import("zod").ZodString;
+        reason: import("zod").ZodEnum<{
+            document_not_found: "document_not_found";
+            unparseable: "unparseable";
+        }>;
+    }, import("zod/v4/core").$strip>>;
+    partial: import("zod").ZodBoolean;
+    structured_coverage_from: import("zod").ZodString;
+    legacy_filings_before_coverage: import("zod").ZodNumber;
+    filings: import("zod").ZodArray<import("zod").ZodObject<{
         form: import("zod").ZodString;
+        schedule: import("zod").ZodEnum<{
+            "13D": "13D";
+            "13G": "13G";
+        }>;
+        is_amendment: import("zod").ZodBoolean;
+        amendment_number: import("zod").ZodOptional<import("zod").ZodString>;
+        accession_number: import("zod").ZodString;
         filing_date: import("zod").ZodString;
-        report_date: import("zod").ZodOptional<import("zod").ZodString>;
-        primary_document: import("zod").ZodString;
-        description: import("zod").ZodOptional<import("zod").ZodString>;
+        event_date: import("zod").ZodOptional<import("zod").ZodString>;
+        security_class: import("zod").ZodOptional<import("zod").ZodString>;
+        cusips: import("zod").ZodArray<import("zod").ZodString>;
+        purpose_of_transaction: import("zod").ZodOptional<import("zod").ZodString>;
+        purpose_truncated: import("zod").ZodBoolean;
+        reporting_persons: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            cik: import("zod").ZodOptional<import("zod").ZodString>;
+            citizenship: import("zod").ZodOptional<import("zod").ZodString>;
+            percent_of_class: import("zod").ZodOptional<import("zod").ZodNumber>;
+            aggregate_amount_owned: import("zod").ZodOptional<import("zod").ZodNumber>;
+            sole_voting_power: import("zod").ZodOptional<import("zod").ZodNumber>;
+            shared_voting_power: import("zod").ZodOptional<import("zod").ZodNumber>;
+            sole_dispositive_power: import("zod").ZodOptional<import("zod").ZodNumber>;
+            shared_dispositive_power: import("zod").ZodOptional<import("zod").ZodNumber>;
+            person_types: import("zod").ZodArray<import("zod").ZodString>;
+            excludes_certain_shares: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            notes: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        row_count: import("zod").ZodNumber;
+        expires_at: import("zod").ZodString;
+        truncated: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "issuer_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The issuer input does not resolve to a known EDGAR company";
+    readonly recovery: "Use secedgar_company_search to find the issuer ticker or 10-digit CIK.";
+}, {
+    readonly reason: "ambiguous_issuer";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The issuer name matches several EDGAR companies";
+    readonly recovery: "Retry with the ticker or the 10-digit CIK of the intended issuer from the matches list.";
+}, {
+    readonly reason: "no_filings_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The issuer has no structured SCHEDULE 13D/13G filings matching the requested form kind";
+    readonly recovery: "Use secedgar_search_filings with forms [\"SC 13D\",\"SC 13G\"] to reach the pre-2024-12-18 text filings, then read them with secedgar_get_filing.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
+    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "sec_unreachable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    accession_number: import("zod").ZodString;
+    cik: import("zod").ZodOptional<import("zod").ZodString>;
+    content_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    document: import("zod").ZodOptional<import("zod").ZodString>;
+    include_xbrl: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+    section: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    accession_number: import("zod").ZodString;
+    form: import("zod").ZodOptional<import("zod").ZodString>;
+    filing_date: import("zod").ZodOptional<import("zod").ZodString>;
+    company_name: import("zod").ZodOptional<import("zod").ZodString>;
+    cik: import("zod").ZodString;
+    period_ending: import("zod").ZodOptional<import("zod").ZodString>;
+    primary_document: import("zod").ZodString;
+    requested_document: import("zod").ZodOptional<import("zod").ZodString>;
+    documents: import("zod").ZodObject<{
+        primary: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            size: import("zod").ZodOptional<import("zod").ZodNumber>;
+            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>>;
+        exhibits: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            size: import("zod").ZodOptional<import("zod").ZodNumber>;
+            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>>;
+        auxiliary: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            size: import("zod").ZodOptional<import("zod").ZodNumber>;
+            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>>;
+        xbrl: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            size: import("zod").ZodOptional<import("zod").ZodNumber>;
+            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>>>;
+    }, import("zod/v4/core").$strip>;
+    content: import("zod").ZodString;
+    content_truncated: import("zod").ZodBoolean;
+    content_total_length: import("zod").ZodNumber;
+    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    outline: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        heading: import("zod").ZodString;
+        offset: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>>>;
-    total_filings: import("zod").ZodOptional<import("zod").ZodNumber>;
-    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
-    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        row_count: import("zod").ZodNumber;
-        expires_at: import("zod").ZodString;
-        truncated: import("zod").ZodBoolean;
-    }, import("zod/v4/core").$strip>>;
+    filing_url: import("zod").ZodString;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "no_match";
+    readonly reason: "document_not_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No company matches the query";
-    readonly recovery: "SEC's ticker index reflects the filer's own submissions record, which can differ from the exchange-listed symbol. ETFs and mutual funds resolve only by ticker (e.g. \"VOO\"); operating companies also resolve by full legal name or 10-digit CIK.";
+    readonly when: "A specific document was requested but not present in the filing archive";
+    readonly recovery: "Pick a filename from the categorized document list in the error message.";
 }, {
-    readonly reason: "multiple_matches";
+    readonly reason: "no_documents";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Query is ambiguous and matches several companies";
-    readonly recovery: "Specify a ticker symbol for an exact match instead of a name fragment.";
+    readonly when: "Filing index lists items but no fetchable primary document was found";
+    readonly recovery: "Set document to one of the filenames listed in the error message.";
+}, {
+    readonly reason: "binary_document";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The requested document is a binary entry (scanned image, PDF, archive) with no text to return";
+    readonly recovery: "Pick a text document (.htm, .txt, .xml) from the list in the error message.";
+}, {
+    readonly reason: "filing_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No filing matches the accession number under any candidate CIK";
+    readonly recovery: "Verify the accession number and pass the company CIK explicitly.";
+}, {
+    readonly reason: "offset_out_of_range";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The provided offset is at or beyond the end of the document";
+    readonly recovery: "Use an offset less than the total document length shown in the error message.";
+}, {
+    readonly reason: "section_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The section string matched no detected heading and no line of the document";
+    readonly recovery: "Pick a heading from the outline in the error message, pass a subheading exactly as the document prints it, or use offset paging instead.";
 }, {
     readonly reason: "rate_limited";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
@@ -78,8 +413,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
@@ -88,16 +423,6 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    name: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    name: import("zod").ZodString;
-    dropped: import("zod").ZodBoolean;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "canvas_unavailable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The DataCanvas service is not configured for this deployment";
-    readonly recovery: "Set CANVAS_PROVIDER_TYPE=duckdb in the server environment to enable dataframes.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     fund: import("zod").ZodString;
     series_id: import("zod").ZodOptional<import("zod").ZodString>;
     report_date: import("zod").ZodOptional<import("zod").ZodString>;
@@ -175,8 +500,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
@@ -243,8 +568,71 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    query: import("zod").ZodString;
+    include_filings: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    filing_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    filed_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    filed_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    cik: import("zod").ZodString;
+    name: import("zod").ZodString;
+    tickers: import("zod").ZodArray<import("zod").ZodString>;
+    exchanges: import("zod").ZodArray<import("zod").ZodString>;
+    sic: import("zod").ZodString;
+    sic_description: import("zod").ZodString;
+    state_of_incorporation: import("zod").ZodOptional<import("zod").ZodString>;
+    fiscal_year_end: import("zod").ZodOptional<import("zod").ZodString>;
+    series_id: import("zod").ZodOptional<import("zod").ZodString>;
+    class_id: import("zod").ZodOptional<import("zod").ZodString>;
+    filings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        accession_number: import("zod").ZodString;
+        form: import("zod").ZodString;
+        filing_date: import("zod").ZodString;
+        report_date: import("zod").ZodOptional<import("zod").ZodString>;
+        primary_document: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>>;
+    total_filings: import("zod").ZodOptional<import("zod").ZodNumber>;
+    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        row_count: import("zod").ZodNumber;
+        expires_at: import("zod").ZodString;
+        truncated: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_match";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No company matches the query";
+    readonly recovery: "SEC's ticker index reflects the filer's own submissions record, which can differ from the exchange-listed symbol. ETFs and mutual funds resolve only by ticker (e.g. \"VOO\"); operating companies also resolve by full legal name or 10-digit CIK.";
+}, {
+    readonly reason: "multiple_matches";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Query is ambiguous and matches several companies";
+    readonly recovery: "Specify a ticker symbol for an exact match instead of a name fragment.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
+    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}, {
+    readonly reason: "sec_unreachable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
@@ -303,11 +691,6 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
         truncated: import("zod").ZodBoolean;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "invalid_date_range";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Only one of filed_after or filed_before was provided";
-    readonly recovery: "Provide both filed_after and filed_before, or omit both to search all dates.";
-}, {
     readonly reason: "unresolved_ticker";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "A ticker: targeting token in the query does not resolve to a known company";
@@ -328,119 +711,13 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "missing_criteria";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Neither a full-text query nor a forms filter was provided (a date range cannot stand alone)";
-    readonly recovery: "Provide search terms, or browse by form type (forms: [\"S-1\"]) or entity (ticker:AAPL / cik:320193 in the query) — optionally narrowed by date.";
-}, {
-    readonly reason: "pre2001_full_text_unscoped";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "A date range reaching before 2001-01-01 carries free-text terms with no entity scope — no pre-2001 full-text index exists, and nothing bounds a local scan";
-    readonly recovery: "Add ticker: or cik: entity scope to the query, drop the text terms to browse by form and date, or start the range at 2001-01-01.";
-}, {
-    readonly reason: "rate_limited";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
-    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
-    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}, {
-    readonly reason: "sec_unreachable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}], {
-    readonly effectiveQuery: import("zod").ZodString;
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    accession_number: import("zod").ZodString;
-    cik: import("zod").ZodOptional<import("zod").ZodString>;
-    content_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-    document: import("zod").ZodOptional<import("zod").ZodString>;
-    include_xbrl: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
-    section: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    accession_number: import("zod").ZodString;
-    form: import("zod").ZodOptional<import("zod").ZodString>;
-    filing_date: import("zod").ZodOptional<import("zod").ZodString>;
-    company_name: import("zod").ZodOptional<import("zod").ZodString>;
-    cik: import("zod").ZodString;
-    period_ending: import("zod").ZodOptional<import("zod").ZodString>;
-    primary_document: import("zod").ZodString;
-    requested_document: import("zod").ZodOptional<import("zod").ZodString>;
-    documents: import("zod").ZodObject<{
-        primary: import("zod").ZodArray<import("zod").ZodObject<{
-            name: import("zod").ZodString;
-            type: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            size: import("zod").ZodOptional<import("zod").ZodNumber>;
-            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        }, import("zod/v4/core").$strip>>;
-        exhibits: import("zod").ZodArray<import("zod").ZodObject<{
-            name: import("zod").ZodString;
-            type: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            size: import("zod").ZodOptional<import("zod").ZodNumber>;
-            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        }, import("zod/v4/core").$strip>>;
-        auxiliary: import("zod").ZodArray<import("zod").ZodObject<{
-            name: import("zod").ZodString;
-            type: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            size: import("zod").ZodOptional<import("zod").ZodNumber>;
-            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        }, import("zod/v4/core").$strip>>;
-        xbrl: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
-            name: import("zod").ZodString;
-            type: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            size: import("zod").ZodOptional<import("zod").ZodNumber>;
-            binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        }, import("zod/v4/core").$strip>>>;
-    }, import("zod/v4/core").$strip>;
-    content: import("zod").ZodString;
-    content_truncated: import("zod").ZodBoolean;
-    content_total_length: import("zod").ZodNumber;
-    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
-    outline: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
-        heading: import("zod").ZodString;
-        offset: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>>>;
-    filing_url: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "document_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "A specific document was requested but not present in the filing archive";
-    readonly recovery: "Pick a filename from the categorized document list in the error message.";
-}, {
-    readonly reason: "no_documents";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Filing index lists items but no fetchable primary document was found";
-    readonly recovery: "Set document to one of the filenames listed in the error message.";
-}, {
-    readonly reason: "binary_document";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The requested document is a binary entry (scanned image, PDF, archive) with no text to return";
-    readonly recovery: "Pick a text document (.htm, .txt, .xml) from the list in the error message.";
-}, {
-    readonly reason: "filing_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No filing matches the accession number under any candidate CIK";
-    readonly recovery: "Verify the accession number and pass the company CIK explicitly.";
-}, {
-    readonly reason: "offset_out_of_range";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The provided offset is at or beyond the end of the document";
-    readonly recovery: "Use an offset less than the total document length shown in the error message.";
-}, {
-    readonly reason: "section_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The section string matched no detected heading and no line of the document";
-    readonly recovery: "Pick a heading from the outline in the error message, pass a subheading exactly as the document prints it, or use offset paging instead.";
+    readonly when: "Neither a full-text query nor a forms filter was provided (a date range cannot stand alone)";
+    readonly recovery: "Provide search terms, or browse by form type (forms: [\"S-1\"]) or entity (ticker:AAPL / cik:320193 in the query) — optionally narrowed by date.";
+}, {
+    readonly reason: "pre2001_full_text_unscoped";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "A date range reaching before 2001-01-01 carries free-text terms with no entity scope — no pre-2001 full-text index exists, and nothing bounds a local scan";
+    readonly recovery: "Add ticker: or cik: entity scope to the query, drop the text terms and browse by form type (forms: [\"10-K\"]) and date, or, for a range that reaches 2001, start the range at 2001-01-01.";
 }, {
     readonly reason: "rate_limited";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
@@ -451,11 +728,12 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
+    readonly effectiveQuery: import("zod").ZodString;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -546,8 +824,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
@@ -637,8 +915,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
@@ -657,262 +935,31 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     issuer_ticker: import("zod").ZodOptional<import("zod").ZodString>;
     transactions: import("zod").ZodArray<import("zod").ZodObject<{
         filing_date: import("zod").ZodString;
-        period_of_report: import("zod").ZodOptional<import("zod").ZodString>;
-        accession_number: import("zod").ZodString;
-        reporting_person: import("zod").ZodString;
-        relationship: import("zod").ZodString;
-        security_title: import("zod").ZodString;
-        transaction_date: import("zod").ZodOptional<import("zod").ZodString>;
-        transaction_code: import("zod").ZodString;
-        transaction_type: import("zod").ZodString;
-        is_derivative: import("zod").ZodBoolean;
-        shares_traded: import("zod").ZodOptional<import("zod").ZodNumber>;
-        direction: import("zod").ZodOptional<import("zod").ZodEnum<{
-            acquire: "acquire";
-            dispose: "dispose";
-        }>>;
-        price_per_share: import("zod").ZodOptional<import("zod").ZodNumber>;
-        shares_owned_after: import("zod").ZodOptional<import("zod").ZodNumber>;
-        ownership_type: import("zod").ZodOptional<import("zod").ZodEnum<{
-            direct: "direct";
-            indirect: "indirect";
-        }>>;
-        ownership_nature: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    filings_scanned: import("zod").ZodNumber;
-    filings_other_issuer: import("zod").ZodNumber;
-    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
-    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        row_count: import("zod").ZodNumber;
-        expires_at: import("zod").ZodString;
-        truncated: import("zod").ZodBoolean;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "company_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The company input does not resolve to a known company";
-    readonly recovery: "Use secedgar_company_search to find the correct ticker or CIK.";
-}, {
-    readonly reason: "no_filings_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "A call without a date window finds no Form 4 filings in the recent submissions window";
-    readonly recovery: "Pass filed_after / filed_before to read an older period, or use secedgar_search_filings with forms=[\"4\"] to find the filings.";
-}, {
-    readonly reason: "rate_limited";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
-    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
-    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}, {
-    readonly reason: "sec_unreachable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}], {
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    company: import("zod").ZodString;
-    quarter: import("zod").ZodOptional<import("zod").ZodString>;
-    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
-    consolidate: import("zod").ZodDefault<import("zod").ZodBoolean>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    filer_name: import("zod").ZodString;
-    filer_cik: import("zod").ZodString;
-    reporting_period: import("zod").ZodOptional<import("zod").ZodString>;
-    filing_date: import("zod").ZodString;
-    accession_number: import("zod").ZodString;
-    total_holdings_in_filing: import("zod").ZodNumber;
-    total_positions: import("zod").ZodOptional<import("zod").ZodNumber>;
-    offset: import("zod").ZodNumber;
-    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
-    holdings: import("zod").ZodArray<import("zod").ZodObject<{
-        issuer_name: import("zod").ZodString;
-        title_of_class: import("zod").ZodOptional<import("zod").ZodString>;
-        cusip: import("zod").ZodOptional<import("zod").ZodString>;
-        market_value_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
-        shares_or_principal_amount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        shares_or_principal_type: import("zod").ZodOptional<import("zod").ZodEnum<{
-            PRN: "PRN";
-            SH: "SH";
-        }>>;
-        put_call: import("zod").ZodOptional<import("zod").ZodEnum<{
-            Call: "Call";
-            Put: "Put";
-        }>>;
-        investment_discretion: import("zod").ZodOptional<import("zod").ZodEnum<{
-            DFND: "DFND";
-            OTR: "OTR";
-            SOLE: "SOLE";
-        }>>;
-    }, import("zod/v4/core").$strip>>;
-    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        row_count: import("zod").ZodNumber;
-        expires_at: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "company_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The company input does not resolve to a known company or institution";
-    readonly recovery: "Use secedgar_company_search to find the correct CIK or full entity name.";
-}, {
-    readonly reason: "ambiguous_entity";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The name resolves to multiple EDGAR entities (e.g. several filers sharing a legal name)";
-    readonly recovery: "Retry with the exact 10-digit CIK of the intended filer from the matches list.";
-}, {
-    readonly reason: "no_filings_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No 13F-HR matches — the entity files none, none exists for the requested quarter in the recent submissions window or the archive pages searched, or the manager filed a 13F-NT notice instead (for the requested quarter, or as its only recent 13F filing when no quarter is given)";
-    readonly recovery: "Use secedgar_search_filings with forms=[\"13F-HR\"] for broader search, or check that the entity is an institutional investment manager.";
-}, {
-    readonly reason: "no_info_table";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The 13F-HR filing was found but the information table XML document could not be located";
-    readonly recovery: "Use secedgar_get_filing with the accession number to inspect the filing documents directly.";
-}, {
-    readonly reason: "rate_limited";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
-    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
-    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}, {
-    readonly reason: "sec_unreachable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}], {
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    issuer: import("zod").ZodString;
-    cusip: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
-    quarter: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
-    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    issuer: import("zod").ZodString;
-    resolved_issuer_name: import("zod").ZodOptional<import("zod").ZodString>;
-    resolved_issuer_cik: import("zod").ZodOptional<import("zod").ZodString>;
-    search_mode: import("zod").ZodEnum<{
-        cusip: "cusip";
-        name: "name";
-    }>;
-    search_key: import("zod").ZodString;
-    quarter: import("zod").ZodString;
-    filed_from: import("zod").ZodString;
-    filed_to: import("zod").ZodString;
-    total_filings: import("zod").ZodNumber;
-    total_is_exact: import("zod").ZodBoolean;
-    fetched: import("zod").ZodNumber;
-    holders_in_quarter: import("zod").ZodNumber;
-    holders: import("zod").ZodArray<import("zod").ZodObject<{
-        filer_name: import("zod").ZodString;
-        filer_cik: import("zod").ZodString;
-        accession_number: import("zod").ZodString;
-        filing_date: import("zod").ZodString;
-        form: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        row_count: import("zod").ZodNumber;
-        expires_at: import("zod").ZodString;
-        truncated: import("zod").ZodBoolean;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "issuer_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No cusip was given and the issuer does not resolve to a known EDGAR company";
-    readonly recovery: "Confirm the issuer with secedgar_company_search, or pass the cusip parameter to search the information tables directly.";
-}, {
-    readonly reason: "ambiguous_issuer";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The issuer name matches several EDGAR companies and no cusip was given";
-    readonly recovery: "Retry with the ticker or the 10-digit CIK of the intended issuer from the matches list.";
-}, {
-    readonly reason: "rate_limited";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
-    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
-    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}, {
-    readonly reason: "sec_unreachable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}], {
-    readonly ordering: import("zod").ZodString;
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    issuer: import("zod").ZodString;
-    form_kind: import("zod").ZodDefault<import("zod").ZodEnum<{
-        "13D": "13D";
-        "13G": "13G";
-        all: "all";
-    }>>;
-    include_amendments: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    issuer: import("zod").ZodString;
-    issuer_cik: import("zod").ZodString;
-    issuer_name: import("zod").ZodString;
-    form_kind: import("zod").ZodEnum<{
-        "13D": "13D";
-        "13G": "13G";
-        all: "all";
-    }>;
-    total_structured_filings: import("zod").ZodNumber;
-    filings_parsed: import("zod").ZodNumber;
-    structured_coverage_from: import("zod").ZodString;
-    legacy_filings_before_coverage: import("zod").ZodNumber;
-    filings: import("zod").ZodArray<import("zod").ZodObject<{
-        form: import("zod").ZodString;
-        schedule: import("zod").ZodEnum<{
-            "13D": "13D";
-            "13G": "13G";
-        }>;
-        is_amendment: import("zod").ZodBoolean;
-        amendment_number: import("zod").ZodOptional<import("zod").ZodString>;
-        accession_number: import("zod").ZodString;
-        filing_date: import("zod").ZodString;
-        event_date: import("zod").ZodOptional<import("zod").ZodString>;
-        security_class: import("zod").ZodOptional<import("zod").ZodString>;
-        cusips: import("zod").ZodArray<import("zod").ZodString>;
-        purpose_of_transaction: import("zod").ZodOptional<import("zod").ZodString>;
-        purpose_truncated: import("zod").ZodBoolean;
-        reporting_persons: import("zod").ZodArray<import("zod").ZodObject<{
-            name: import("zod").ZodString;
-            cik: import("zod").ZodOptional<import("zod").ZodString>;
-            citizenship: import("zod").ZodOptional<import("zod").ZodString>;
-            percent_of_class: import("zod").ZodOptional<import("zod").ZodNumber>;
-            aggregate_amount_owned: import("zod").ZodOptional<import("zod").ZodNumber>;
-            sole_voting_power: import("zod").ZodOptional<import("zod").ZodNumber>;
-            shared_voting_power: import("zod").ZodOptional<import("zod").ZodNumber>;
-            sole_dispositive_power: import("zod").ZodOptional<import("zod").ZodNumber>;
-            shared_dispositive_power: import("zod").ZodOptional<import("zod").ZodNumber>;
-            person_types: import("zod").ZodArray<import("zod").ZodString>;
-            excludes_certain_shares: import("zod").ZodOptional<import("zod").ZodBoolean>;
-            notes: import("zod").ZodOptional<import("zod").ZodString>;
-        }, import("zod/v4/core").$strip>>;
+        period_of_report: import("zod").ZodOptional<import("zod").ZodString>;
+        accession_number: import("zod").ZodString;
+        reporting_person: import("zod").ZodString;
+        relationship: import("zod").ZodString;
+        security_title: import("zod").ZodString;
+        transaction_date: import("zod").ZodOptional<import("zod").ZodString>;
+        transaction_code: import("zod").ZodString;
+        transaction_type: import("zod").ZodString;
+        is_derivative: import("zod").ZodBoolean;
+        shares_traded: import("zod").ZodOptional<import("zod").ZodNumber>;
+        direction: import("zod").ZodOptional<import("zod").ZodEnum<{
+            acquire: "acquire";
+            dispose: "dispose";
+        }>>;
+        price_per_share: import("zod").ZodOptional<import("zod").ZodNumber>;
+        shares_owned_after: import("zod").ZodOptional<import("zod").ZodNumber>;
+        ownership_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+            direct: "direct";
+            indirect: "indirect";
+        }>>;
+        ownership_nature: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>>;
+    filings_scanned: import("zod").ZodNumber;
+    filings_other_issuer: import("zod").ZodNumber;
+    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
     dataset: import("zod").ZodOptional<import("zod").ZodObject<{
         name: import("zod").ZodString;
         row_count: import("zod").ZodNumber;
@@ -920,20 +967,15 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
         truncated: import("zod").ZodBoolean;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "issuer_not_found";
+    readonly reason: "company_not_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The issuer input does not resolve to a known EDGAR company";
-    readonly recovery: "Use secedgar_company_search to find the issuer ticker or 10-digit CIK.";
-}, {
-    readonly reason: "ambiguous_issuer";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The issuer name matches several EDGAR companies";
-    readonly recovery: "Retry with the ticker or the 10-digit CIK of the intended issuer from the matches list.";
+    readonly when: "The company input does not resolve to a known company";
+    readonly recovery: "Use secedgar_company_search to find the correct ticker or CIK.";
 }, {
     readonly reason: "no_filings_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The issuer has no structured SCHEDULE 13D/13G filings matching the requested form kind";
-    readonly recovery: "Use secedgar_search_filings with forms [\"SC 13D\",\"SC 13G\"] to reach the pre-2024-12-18 text filings, then read them with secedgar_get_filing.";
+    readonly when: "A call without a date window finds no Form 4 filings in the recent submissions window";
+    readonly recovery: "Pass filed_after / filed_before to read an older period, or use secedgar_search_filings with forms=[\"4\"] to find the filings.";
 }, {
     readonly reason: "rate_limited";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
@@ -944,8 +986,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
@@ -954,75 +996,85 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    concept: import("zod").ZodString;
-    taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
-        dei: "dei";
-        "us-gaap": "us-gaap";
-    }>>;
-    period: import("zod").ZodString;
-    unit: import("zod").ZodDefault<import("zod").ZodEnum<{
-        USD: "USD";
-        "USD-per-shares": "USD-per-shares";
-        "USD/shares": "USD/shares";
-        pure: "pure";
-        shares: "shares";
-    }>>;
+    company: import("zod").ZodString;
+    quarter: import("zod").ZodOptional<import("zod").ZodString>;
     limit: import("zod").ZodDefault<import("zod").ZodNumber>;
     offset: import("zod").ZodDefault<import("zod").ZodNumber>;
-    sort: import("zod").ZodDefault<import("zod").ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
+    consolidate: import("zod").ZodDefault<import("zod").ZodBoolean>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    concept: import("zod").ZodString;
-    taxonomy: import("zod").ZodString;
-    period: import("zod").ZodString;
-    unit: import("zod").ZodString;
-    label: import("zod").ZodString;
-    total_companies: import("zod").ZodNumber;
+    filer_name: import("zod").ZodString;
+    filer_cik: import("zod").ZodString;
+    reporting_period: import("zod").ZodOptional<import("zod").ZodString>;
+    filing_date: import("zod").ZodString;
+    accession_number: import("zod").ZodString;
+    amendments: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        accession_number: import("zod").ZodString;
+        filing_date: import("zod").ZodString;
+        amendment_type: import("zod").ZodEnum<{
+            "NEW HOLDINGS": "NEW HOLDINGS";
+            RESTATEMENT: "RESTATEMENT";
+        }>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        accession_number: import("zod").ZodString;
+        filing_date: import("zod").ZodString;
+        amendment_type: import("zod").ZodLiteral<"UNAVAILABLE">;
+        unavailable_reason: import("zod").ZodEnum<{
+            lookup_failed: "lookup_failed";
+            lookup_stopped: "lookup_stopped";
+            missing_header: "missing_header";
+            unreadable_header: "unreadable_header";
+        }>;
+    }, import("zod/v4/core").$strip>], "amendment_type">>>;
+    amendment_search_complete: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    total_holdings_in_filing: import("zod").ZodNumber;
+    total_positions: import("zod").ZodOptional<import("zod").ZodNumber>;
     offset: import("zod").ZodNumber;
     next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
-    data: import("zod").ZodArray<import("zod").ZodObject<{
-        rank: import("zod").ZodNumber;
-        company_name: import("zod").ZodString;
-        cik: import("zod").ZodString;
-        ticker: import("zod").ZodOptional<import("zod").ZodString>;
-        value: import("zod").ZodNumber;
-        location: import("zod").ZodOptional<import("zod").ZodString>;
-        period_end: import("zod").ZodString;
-        accession_number: import("zod").ZodString;
+    holdings: import("zod").ZodArray<import("zod").ZodObject<{
+        issuer_name: import("zod").ZodString;
+        title_of_class: import("zod").ZodOptional<import("zod").ZodString>;
+        cusip: import("zod").ZodOptional<import("zod").ZodString>;
+        market_value_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
+        shares_or_principal_amount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        shares_or_principal_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+            PRN: "PRN";
+            SH: "SH";
+        }>>;
+        put_call: import("zod").ZodOptional<import("zod").ZodEnum<{
+            Call: "Call";
+            Put: "Put";
+        }>>;
+        investment_discretion: import("zod").ZodOptional<import("zod").ZodEnum<{
+            DFND: "DFND";
+            OTR: "OTR";
+            SOLE: "SOLE";
+        }>>;
     }, import("zod/v4/core").$strip>>;
     dataset: import("zod").ZodOptional<import("zod").ZodObject<{
         name: import("zod").ZodString;
         row_count: import("zod").ZodNumber;
         expires_at: import("zod").ZodString;
     }, import("zod/v4/core").$strip>>;
-    unqueried_tags: import("zod").ZodArray<import("zod").ZodString>;
-    related_tags: import("zod").ZodArray<import("zod").ZodObject<{
-        tag: import("zod").ZodString;
-        note: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-    value_distribution: import("zod").ZodObject<{
-        median: import("zod").ZodNumber;
-        p95: import("zod").ZodNumber;
-        max: import("zod").ZodNumber;
-        max_to_p95_ratio: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>;
-    period_end_range: import("zod").ZodObject<{
-        min: import("zod").ZodString;
-        max: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>;
-    caveats: import("zod").ZodArray<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_concept";
+    readonly reason: "company_not_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
-    readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
+    readonly when: "The company input does not resolve to a known company or institution";
+    readonly recovery: "Use secedgar_company_search to find the correct CIK or full entity name.";
 }, {
-    readonly reason: "no_data";
+    readonly reason: "ambiguous_entity";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The name resolves to multiple EDGAR entities (e.g. several filers sharing a legal name)";
+    readonly recovery: "Retry with the exact 10-digit CIK of the intended filer from the matches list.";
+}, {
+    readonly reason: "no_filings_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Concept resolves but no companies report this metric for the requested period and unit";
-    readonly recovery: "Check duration vs instant period, unit, and that the period exists post-CY2009.";
+    readonly when: "No 13F-HR matches — the entity files none, none exists for the requested quarter in the recent submissions window or the archive pages searched, or the manager filed a 13F-NT notice instead (for the requested quarter, or as its only recent 13F filing when no quarter is given)";
+    readonly recovery: "Use secedgar_search_filings with forms=[\"13F-HR\"] for broader search, or check that the entity is an institutional investment manager.";
+}, {
+    readonly reason: "no_info_table";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The 13F-HR filing was found but the information table XML document could not be located";
+    readonly recovery: "Use secedgar_get_filing with the accession number to inspect the filing documents directly.";
 }, {
     readonly reason: "rate_limited";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
@@ -1033,8 +1085,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
@@ -1043,87 +1095,49 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    companies: import("zod").ZodArray<import("zod").ZodString>;
-    concepts: import("zod").ZodArray<import("zod").ZodString>;
-    taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
-        "ifrs-full": "ifrs-full";
-        "us-gaap": "us-gaap";
-    }>>;
-    period_type: import("zod").ZodDefault<import("zod").ZodEnum<{
-        annual: "annual";
-        quarterly: "quarterly";
-    }>>;
-    periods: import("zod").ZodDefault<import("zod").ZodNumber>;
+    issuer: import("zod").ZodString;
+    cusip: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    quarter: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    period_type: import("zod").ZodString;
-    taxonomy: import("zod").ZodString;
-    periods: import("zod").ZodArray<import("zod").ZodString>;
-    companies: import("zod").ZodArray<import("zod").ZodObject<{
-        input: import("zod").ZodString;
-        cik: import("zod").ZodString;
-        name: import("zod").ZodString;
-        ticker: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    failed_companies: import("zod").ZodArray<import("zod").ZodObject<{
-        input: import("zod").ZodString;
-        reason: import("zod").ZodEnum<{
-            ambiguous: "ambiguous";
-            no_company_facts: "no_company_facts";
-            not_found: "not_found";
-        }>;
-        message: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-    concepts: import("zod").ZodArray<import("zod").ZodObject<{
-        concept: import("zod").ZodString;
-        label: import("zod").ZodString;
-        units: import("zod").ZodArray<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    cells: import("zod").ZodArray<import("zod").ZodObject<{
-        cik: import("zod").ZodString;
-        company: import("zod").ZodString;
-        concept: import("zod").ZodString;
-        period: import("zod").ZodString;
-        value: import("zod").ZodNumber;
-        unit: import("zod").ZodString;
-        taxonomy: import("zod").ZodString;
-        tag: import("zod").ZodString;
-        frame: import("zod").ZodString;
-        period_end: import("zod").ZodString;
-        form: import("zod").ZodString;
+    issuer: import("zod").ZodString;
+    resolved_issuer_name: import("zod").ZodOptional<import("zod").ZodString>;
+    resolved_issuer_cik: import("zod").ZodOptional<import("zod").ZodString>;
+    search_mode: import("zod").ZodEnum<{
+        cusip: "cusip";
+        name: "name";
+    }>;
+    search_key: import("zod").ZodString;
+    quarter: import("zod").ZodString;
+    filed_from: import("zod").ZodString;
+    filed_to: import("zod").ZodString;
+    total_filings: import("zod").ZodNumber;
+    total_is_exact: import("zod").ZodBoolean;
+    fetched: import("zod").ZodNumber;
+    holders_in_quarter: import("zod").ZodNumber;
+    holders: import("zod").ZodArray<import("zod").ZodObject<{
+        filer_name: import("zod").ZodString;
+        filer_cik: import("zod").ZodString;
         accession_number: import("zod").ZodString;
+        filing_date: import("zod").ZodString;
+        form: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>>;
-    gaps: import("zod").ZodArray<import("zod").ZodObject<{
-        cik: import("zod").ZodString;
-        company: import("zod").ZodString;
-        concept: import("zod").ZodString;
-        tags_tried: import("zod").ZodArray<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    unknown_concepts: import("zod").ZodArray<import("zod").ZodObject<{
-        concept: import("zod").ZodString;
-        derivation: import("zod").ZodOptional<import("zod").ZodString>;
-        suggestions: import("zod").ZodArray<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    caveats: import("zod").ZodArray<import("zod").ZodString>;
     dataset: import("zod").ZodOptional<import("zod").ZodObject<{
         name: import("zod").ZodString;
         row_count: import("zod").ZodNumber;
         expires_at: import("zod").ZodString;
+        truncated: import("zod").ZodBoolean;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "no_companies_resolved";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "None of the supplied company inputs resolved to a CIK";
-    readonly recovery: "Use ticker symbols or 10-digit CIK numbers for exact matches.";
-}, {
-    readonly reason: "no_comparable_data";
+    readonly reason: "issuer_not_found";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Companies resolved but not one of them reports any of the requested concepts for the requested period type";
-    readonly recovery: "Switch period_type, or discover reported concept names with secedgar_search_concepts.";
+    readonly when: "No cusip was given and the issuer does not resolve to a known EDGAR company";
+    readonly recovery: "Confirm the issuer with secedgar_company_search, or pass the cusip parameter to search the information tables directly.";
 }, {
-    readonly reason: "unknown_concept";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Every requested concept is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
-    readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
+    readonly reason: "ambiguous_issuer";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The issuer name matches several EDGAR companies and no cusip was given";
+    readonly recovery: "Retry with the ticker or the 10-digit CIK of the intended issuer from the matches list.";
 }, {
     readonly reason: "rate_limited";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
@@ -1134,11 +1148,12 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, {
     readonly reason: "sec_unreachable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
-    readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
+    readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
+    readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
     readonly retryable: true;
     readonly thrownBy: "service";
 }], {
+    readonly ordering: import("zod").ZodString;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -1206,7 +1221,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly reason: "canvas_unavailable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "The DataCanvas service is not configured for this deployment";
-    readonly recovery: "Set CANVAS_PROVIDER_TYPE=duckdb in the server environment to enable dataframes.";
+    readonly recovery: "Dataframes need the DuckDB canvas. On an npm or Docker install, set CANVAS_PROVIDER_TYPE=duckdb (the default when unset) and restart the server; the MCPB bundle ships without DuckDB, so there the data tools return their results inline and stage no dataframe.";
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     sql: import("zod").ZodString;
     register_as: import("zod").ZodOptional<import("zod").ZodString>;
@@ -1223,7 +1238,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly reason: "canvas_unavailable";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly when: "The DataCanvas service is not configured for this deployment";
-    readonly recovery: "Set CANVAS_PROVIDER_TYPE=duckdb in the server environment to enable dataframes.";
+    readonly recovery: "Dataframes need the DuckDB canvas. On an npm or Docker install, set CANVAS_PROVIDER_TYPE=duckdb (the default when unset) and restart the server; the MCPB bundle ships without DuckDB, so there the data tools return their results inline and stage no dataframe.";
 }, {
     readonly reason: "system_catalog_access";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
@@ -1289,5 +1304,15 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-}>)[];
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    dropped: import("zod").ZodBoolean;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "canvas_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The DataCanvas service is not configured for this deployment";
+    readonly recovery: "Dataframes need the DuckDB canvas. On an npm or Docker install, set CANVAS_PROVIDER_TYPE=duckdb (the default when unset) and restart the server; the MCPB bundle ships without DuckDB, so there the data tools return their results inline and stage no dataframe.";
+}], undefined>)[];
 //# sourceMappingURL=index.d.ts.map