@cyanheads/secedgar-mcp-server 0.15.3 → 0.15.5

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

@@ -0,0 +1,1034 @@
+/**
+ * @fileoverview The tool registration list handed to `createApp()` — every
+ * secedgar tool definition, including the ones this deployment gates off.
+ *
+ * A gated tool stays in the list rather than being omitted from it:
+ * `secedgar_dataframe_drop` is wrapped with `disabledTool()` when
+ * `EDGAR_DATAFRAME_DROP_ENABLED` is off, which keeps it out of MCP registration
+ * (clients cannot list or call it) while leaving it visible — with its reason
+ * and enable hint — on the HTTP landing page, so an operator auditing the
+ * server can see the capability exists and what turns it on (#103).
+ *
+ * @module mcp-server/tools/definitions/index
+ */
+/** Deployment gates that decide how a tool enters the registration list. */
+export interface ToolDefinitionOptions {
+    /**
+     * `EDGAR_DATAFRAME_DROP_ENABLED`. When false, `secedgar_dataframe_drop` is
+     * registered through `disabledTool()` instead of live.
+     */
+    dropEnabled: boolean;
+}
+/**
+ * Build the tool list for `createApp({ tools })`. Length is constant across
+ * deployments — the drop gate changes how the tool is registered, never whether
+ * 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<{
+    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>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    fund: import("zod").ZodString;
+    series_id: import("zod").ZodOptional<import("zod").ZodString>;
+    series_name: import("zod").ZodOptional<import("zod").ZodString>;
+    class_ids: import("zod").ZodArray<import("zod").ZodString>;
+    registrant_cik: import("zod").ZodString;
+    registrant_name: import("zod").ZodString;
+    report_period_date: import("zod").ZodOptional<import("zod").ZodString>;
+    report_period_end: import("zod").ZodOptional<import("zod").ZodString>;
+    filing_date: import("zod").ZodString;
+    publication_lag_days: import("zod").ZodOptional<import("zod").ZodNumber>;
+    form: import("zod").ZodString;
+    accession_number: import("zod").ZodString;
+    is_final_filing: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    net_assets_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total_assets_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total_liabilities_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total_holdings: import("zod").ZodNumber;
+    offset: import("zod").ZodNumber;
+    next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    available_report_periods: import("zod").ZodArray<import("zod").ZodString>;
+    holdings: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        cusip: import("zod").ZodOptional<import("zod").ZodString>;
+        isin: import("zod").ZodOptional<import("zod").ZodString>;
+        lei: import("zod").ZodOptional<import("zod").ZodString>;
+        balance: import("zod").ZodOptional<import("zod").ZodNumber>;
+        units: import("zod").ZodOptional<import("zod").ZodString>;
+        currency: import("zod").ZodOptional<import("zod").ZodString>;
+        value_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
+        percent_of_net_assets: import("zod").ZodOptional<import("zod").ZodNumber>;
+        payoff_profile: import("zod").ZodOptional<import("zod").ZodString>;
+        asset_category: import("zod").ZodOptional<import("zod").ZodString>;
+        issuer_category: import("zod").ZodOptional<import("zod").ZodString>;
+        country: 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;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "fund_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The fund input resolves to neither an EDGAR company nor a known fund series";
+    readonly recovery: "Use secedgar_company_search with the fund ticker to get its CIK and series ID.";
+}, {
+    readonly reason: "ambiguous_fund";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The fund name matches several EDGAR companies";
+    readonly recovery: "Retry with the fund ticker or the 10-digit CIK from the matches list.";
+}, {
+    readonly reason: "series_required";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The input resolves to a registrant trust that files reports for more than one fund series";
+    readonly recovery: "Retry with series_id set to one of the listed series, or pass a fund ticker.";
+}, {
+    readonly reason: "no_filings_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No NPORT-P report exists for this fund, or none for the requested report_date";
+    readonly recovery: "Drop report_date to take the newest report, or use secedgar_search_filings with forms [\"NPORT-P\"] to see what the registrant has filed.";
+}], {
+    readonly as_of: 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<{
+    company: import("zod").ZodString;
+    items: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        [x: string]: string;
+    }>>>;
+    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]>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    cik: import("zod").ZodString;
+    company_name: import("zod").ZodString;
+    items_filter: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    total_matched: import("zod").ZodNumber;
+    total_8k_scanned: import("zod").ZodNumber;
+    item_distribution: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
+    filings: 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").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        items: import("zod").ZodArray<import("zod").ZodObject<{
+            code: import("zod").ZodString;
+            label: import("zod").ZodOptional<import("zod").ZodString>;
+            regime: import("zod").ZodOptional<import("zod").ZodEnum<{
+                current: "current";
+                legacy: "legacy";
+            }>>;
+        }, 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: "no_match";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No company matches the query";
+    readonly recovery: "Use a ticker symbol or 10-digit CIK for an exact match, or find the company with secedgar_company_search.";
+}, {
+    readonly reason: "multiple_matches";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The query is ambiguous and matches several companies";
+    readonly recovery: "Retry with a ticker symbol or the 10-digit CIK from the matches list.";
+}], {
+    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>;
+    form_types: 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: "Check `data.suggestions` for near matches. 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 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").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    start_date: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    end_date: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+    sort: import("zod").ZodDefault<import("zod").ZodEnum<{
+        filing_date_asc: "filing_date_asc";
+        filing_date_desc: "filing_date_desc";
+        relevance: "relevance";
+    }>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    total: import("zod").ZodNumber;
+    total_is_exact: import("zod").ZodBoolean;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        accession_number: import("zod").ZodString;
+        form: import("zod").ZodOptional<import("zod").ZodString>;
+        filing_date: import("zod").ZodString;
+        period_ending: import("zod").ZodOptional<import("zod").ZodString>;
+        company_name: import("zod").ZodString;
+        cik: import("zod").ZodString;
+        ticker: import("zod").ZodOptional<import("zod").ZodString>;
+        file_description: import("zod").ZodOptional<import("zod").ZodString>;
+        sic: import("zod").ZodOptional<import("zod").ZodString>;
+        location: import("zod").ZodOptional<import("zod").ZodString>;
+        source: import("zod").ZodOptional<import("zod").ZodEnum<{
+            efts: "efts";
+            "full-index": "full-index";
+            submissions: "submissions";
+        }>>;
+    }, import("zod/v4/core").$strip>>;
+    form_distribution: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>>;
+    scan: import("zod").ZodOptional<import("zod").ZodObject<{
+        candidates: import("zod").ZodNumber;
+        scanned: import("zod").ZodNumber;
+        matched: import("zod").ZodNumber;
+        capped: import("zod").ZodBoolean;
+    }, 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: "invalid_date_range";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Only one of start_date or end_date was provided";
+    readonly recovery: "Provide both start_date and end_date, 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";
+    readonly recovery: "Verify the symbol with secedgar_company_search, or target by CIK with cik:<number> instead.";
+}, {
+    readonly reason: "invalid_cik";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "A cik: targeting token in the query is not a 1-10 digit number";
+    readonly recovery: "Pass a numeric CIK such as cik:320193 — find it with secedgar_company_search if unknown.";
+}, {
+    readonly reason: "entity_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "A cik: targeting token on a pre-2001 date range names a CIK with no EDGAR submissions history";
+    readonly recovery: "Confirm the CIK with secedgar_company_search — an accession-number prefix names the filing agent, not the issuer.";
+}, {
+    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 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 did not match any detected heading in the document";
+    readonly recovery: "Pick a heading from the outline in the error message, or use offset paging instead.";
+}], {
+    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;
+    concept: import("zod").ZodString;
+    taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
+        dei: "dei";
+        "ifrs-full": "ifrs-full";
+        "us-gaap": "us-gaap";
+    }>>;
+    period_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+        all: "all";
+        annual: "annual";
+        quarterly: "quarterly";
+    }>>;
+    limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    company: import("zod").ZodString;
+    cik: import("zod").ZodString;
+    concept: import("zod").ZodString;
+    label: import("zod").ZodString;
+    description: import("zod").ZodOptional<import("zod").ZodString>;
+    unit: import("zod").ZodString;
+    data: import("zod").ZodArray<import("zod").ZodObject<{
+        period: import("zod").ZodString;
+        value: import("zod").ZodNumber;
+        start: import("zod").ZodOptional<import("zod").ZodString>;
+        end: import("zod").ZodString;
+        fiscal_year: import("zod").ZodNullable<import("zod").ZodNumber>;
+        fiscal_period: import("zod").ZodNullable<import("zod").ZodString>;
+        form: import("zod").ZodString;
+        filed: import("zod").ZodString;
+        accession_number: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    tags_tried: import("zod").ZodOptional<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>>;
+    caveats: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}, 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 CIK";
+    readonly recovery: "Use a ticker symbol or 10-digit CIK number for an exact match.";
+}, {
+    readonly reason: "ambiguous_company";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The company input resolves to multiple entities and the target is ambiguous";
+    readonly recovery: "Use a ticker symbol or 10-digit CIK from the matches list for an exact match.";
+}, {
+    readonly reason: "no_concept_data";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The company does not report any XBRL data for the resolved concept and taxonomy";
+    readonly recovery: "Try a raw XBRL tag, switch taxonomy to ifrs-full, or use a related concept.";
+}, {
+    readonly reason: "no_frame_data";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Concept exists but has no frame-aligned (standard calendar period) entries";
+    readonly recovery: "Try a related concept that reports against standard calendar periods.";
+}, {
+    readonly reason: "no_period_data";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Concept has data but the period_type filter excluded all of it";
+    readonly recovery: "Switch period_type to \"quarterly\" or \"all\" for balance sheet items.";
+}], {
+    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;
+    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";
+        both: "both";
+        quarterly: "quarterly";
+    }>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    company: import("zod").ZodString;
+    cik: import("zod").ZodString;
+    taxonomy: import("zod").ZodString;
+    period_type: import("zod").ZodString;
+    concepts_resolved: import("zod").ZodNumber;
+    concepts_total: import("zod").ZodNumber;
+    lines: import("zod").ZodArray<import("zod").ZodObject<{
+        concept: import("zod").ZodString;
+        label: import("zod").ZodString;
+        group: import("zod").ZodString;
+        taxonomy: import("zod").ZodString;
+        tag: import("zod").ZodString;
+        unit: import("zod").ZodString;
+        annual: import("zod").ZodOptional<import("zod").ZodObject<{
+            period: import("zod").ZodString;
+            value: import("zod").ZodNumber;
+            period_end: import("zod").ZodString;
+            form: import("zod").ZodString;
+            accession_number: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+        quarterly: import("zod").ZodOptional<import("zod").ZodObject<{
+            period: import("zod").ZodString;
+            value: import("zod").ZodNumber;
+            period_end: import("zod").ZodString;
+            form: import("zod").ZodString;
+            accession_number: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+        instant: import("zod").ZodOptional<import("zod").ZodObject<{
+            period: import("zod").ZodString;
+            value: import("zod").ZodNumber;
+            period_end: import("zod").ZodString;
+            form: import("zod").ZodString;
+            accession_number: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    gaps: import("zod").ZodArray<import("zod").ZodObject<{
+        concept: import("zod").ZodString;
+        label: import("zod").ZodString;
+        group: import("zod").ZodString;
+        tags_tried: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    caveats: import("zod").ZodArray<import("zod").ZodString>;
+}, 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 CIK";
+    readonly recovery: "Use a ticker symbol or 10-digit CIK number for an exact match.";
+}, {
+    readonly reason: "ambiguous_company";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The company input resolves to multiple entities and the target is ambiguous";
+    readonly recovery: "Use a ticker symbol or 10-digit CIK from the matches list for an exact match.";
+}, {
+    readonly reason: "no_company_facts";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The filer has no XBRL facts at all — pre-XBRL, foreign private issuer, or a non-operating registrant";
+    readonly recovery: "Check the filer files XBRL financial statements, or read the filings directly with secedgar_search_filings.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    ticker_or_cik: import("zod").ZodString;
+    transaction_type: import("zod").ZodDefault<import("zod").ZodEnum<{
+        all: "all";
+        purchase: "purchase";
+        sale: "sale";
+    }>>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    issuer_name: import("zod").ZodString;
+    issuer_cik: import("zod").ZodString;
+    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;
+    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 ticker or CIK 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: "No Form 4 filings exist for this company in the recent submissions window";
+    readonly recovery: "Use secedgar_search_filings with forms=[\"4\"] for broader historical coverage.";
+}], {
+    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<{
+    ticker_or_cik: 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 ticker or CIK 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 filings found for this entity in the recent submissions window";
+    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 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 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>>;
+    }, 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 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;
+    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;
+    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 does not match a friendly name and SEC frames returned no data";
+    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 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<{
+    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<{
+    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>>;
+    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 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<{
+    search: import("zod").ZodOptional<import("zod").ZodString>;
+    group: import("zod").ZodOptional<import("zod").ZodEnum<{
+        balance_sheet: "balance_sheet";
+        cash_flow: "cash_flow";
+        entity_info: "entity_info";
+        income_statement: "income_statement";
+        per_share: "per_share";
+    }>>;
+    taxonomy: import("zod").ZodOptional<import("zod").ZodEnum<{
+        dei: "dei";
+        "ifrs-full": "ifrs-full";
+        "us-gaap": "us-gaap";
+    }>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    total: import("zod").ZodNumber;
+    concepts: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        label: import("zod").ZodString;
+        tags: import("zod").ZodArray<import("zod").ZodString>;
+        ifrs_tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        related_tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            tag: import("zod").ZodString;
+            note: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>>;
+        taxonomy: import("zod").ZodEnum<{
+            dei: "dei";
+            "ifrs-full": "ifrs-full";
+            "us-gaap": "us-gaap";
+        }>;
+        unit: import("zod").ZodString;
+        group: import("zod").ZodEnum<{
+            balance_sheet: "balance_sheet";
+            cash_flow: "cash_flow";
+            entity_info: "entity_info";
+            income_statement: "income_statement";
+            per_share: "per_share";
+        }>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, undefined, {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    dataframes: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        source_tool: import("zod").ZodString;
+        query_params: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        created_at: import("zod").ZodString;
+        expires_at: import("zod").ZodString;
+        row_count: import("zod").ZodNumber;
+        truncated: import("zod").ZodBoolean;
+        max_rows: import("zod").ZodOptional<import("zod").ZodNumber>;
+        column_schema: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            nullable: import("zod").ZodBoolean;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+}, 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<{
+    sql: import("zod").ZodString;
+    register_as: import("zod").ZodOptional<import("zod").ZodString>;
+    preview: import("zod").ZodOptional<import("zod").ZodNumber>;
+    row_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    columns: import("zod").ZodArray<import("zod").ZodString>;
+    row_count: import("zod").ZodNumber;
+    row_count_capped: import("zod").ZodBoolean;
+    rows: import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    registered_as: import("zod").ZodOptional<import("zod").ZodString>;
+    expires_at: import("zod").ZodOptional<import("zod").ZodString>;
+}, 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.";
+}, {
+    readonly reason: "system_catalog_access";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The SQL query references a denied DuckDB system catalog (information_schema, pg_catalog, sqlite_master, duckdb_*)";
+    readonly recovery: "Query only df_<id> tables. Use secedgar_dataframe_describe to list available dataframes.";
+}, {
+    readonly reason: "missing_table";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The SQL query references a df_<id> table that does not exist or has expired";
+    readonly recovery: "Use secedgar_dataframe_describe to list available dataframes and verify the table name.";
+}, {
+    readonly reason: "invalid_sql";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The SQL statement contains a syntax or execution error not covered by a more specific reason";
+    readonly recovery: "Check SQL syntax, column names, and table references against secedgar_dataframe_describe.";
+}, {
+    readonly reason: "register_as_clash";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The register_as target name already exists on the canvas";
+    readonly recovery: "Drop the existing dataframe with secedgar_dataframe_drop (when enabled), choose a different df_XXXXX_XXXXX name, or omit register_as.";
+}, {
+    readonly reason: "non_select_statement";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The SQL is a non-SELECT statement (DROP, INSERT, UPDATE, DDL, etc.) — only read-only SELECTs run against dataframes";
+    readonly recovery: "Query only SELECT statements against df_<id> tables. Use secedgar_dataframe_describe to inspect available dataframes.";
+}], {
+    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>;
+}>)[];
+//# sourceMappingURL=index.d.ts.map