/**
 * @fileoverview Return the single most recent observation for one or more BLS
 * series. Issues one GET request per SeriesID — each consumes one of the 500
 * daily API queries. Prefer bls_get_series with a 1-year window for large
 * batches; bls_get_latest is optimised for the single-series "current value" ask.
 * @module mcp-server/tools/definitions/bls-get-latest
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const blsGetLatestTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    series_ids: z.ZodArray<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    results: z.ZodArray<z.ZodObject<{
        seriesId: z.ZodString;
        title: z.ZodOptional<z.ZodString>;
        area: z.ZodOptional<z.ZodString>;
        item: z.ZodOptional<z.ZodString>;
        seasonal: z.ZodOptional<z.ZodString>;
        latestObservation: z.ZodOptional<z.ZodObject<{
            year: z.ZodString;
            period: z.ZodString;
            periodName: z.ZodOptional<z.ZodString>;
            value: z.ZodString;
            footnotes: z.ZodOptional<z.ZodArray<z.ZodString>>;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
    succeeded: z.ZodNumber;
    failed: z.ZodArray<z.ZodObject<{
        seriesId: z.ZodString;
        error: z.ZodString;
    }, z.core.$strip>>;
}, z.core.$strip>, readonly [{
    readonly reason: "invalid_api_key";
    readonly code: JsonRpcErrorCode.ConfigurationError;
    readonly when: "BLS rejected the configured BLS_API_KEY as invalid.";
    readonly retryable: false;
    readonly recovery: "Set BLS_API_KEY to a valid key and restart the server — register free at https://data.bls.gov/registrationEngine/. This is a configuration error: it does not clear at the UTC quota reset.";
}, {
    readonly reason: "quota_exceeded";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "The BLS API 500 query/day limit has been reached.";
    readonly retryable: false;
    readonly recovery: "The daily quota resets at UTC midnight. Retry after midnight or reduce query volume.";
}, {
    readonly reason: "series_locked";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "The BLS database is temporarily locked for the requested series.";
    readonly recovery: "The BLS database lock is transient — retry the request after a brief delay.";
}], {
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=bls-get-latest.tool.d.ts.map