/**
 * DeepSeek search through an Anthropic-compatible Messages model call with the native
 * `web_search_20250305` server tool. Each search costs a model turn, but returns structured
 * result blocks; absence of those blocks is an error rather than a prose-scraping fallback.
 * The wire format and native `fetch` client are provider-private and do not use `ctx.llm`.
 * @module @deepseek-ai/dsh-web-search-deepseek/provider
 */
import type { WebSearchProvider, WebSearchRequest, WebSearchResult } from '@deepseek-ai/dsh-web';
import type { CredentialRef } from '@deepseek-ai/dsh-credentials';
import type { AnthropicResponse, ContentBlock } from './types.ts';
/** Stable id this provider registers under. */
export declare const DEEPSEEK_PROVIDER_ID = "deepseek-official";
/**
 * Default endpoint: DeepSeek's Anthropic-compatible surface, `/v1` included
 * (`/messages` is appended). This is NOT the chat-completions base
 * (`https://api.deepseek.com`) `@deepseek-ai/dsh-llm-deepseek` uses, so this
 * provider does NOT reuse `$DEEPSEEK_BASE_URL` — only the API key is shared.
 */
export declare const DEEPSEEK_DEFAULT_BASE_URL = "https://api.deepseek.com/anthropic/v1";
/** Default Anthropic-format model name (aligned with the repo's DeepSeek model vocabulary). */
export declare const DEEPSEEK_DEFAULT_MODEL = "deepseek-v4-flash";
/** Default `anthropic-version` header value. */
export declare const DEEPSEEK_DEFAULT_API_VERSION = "2023-06-01";
/** Default upper bound on generated tokens for the Messages request. */
export declare const DEEPSEEK_DEFAULT_MAX_TOKENS = 4096;
/** Default maximum `web_search` server-tool uses per request. */
export declare const DEEPSEEK_DEFAULT_MAX_USES = 5;
/**
 * Exact secret-free DeepSeek Messages request recorded immediately before one
 * auxiliary search dispatch.
 */
export interface DeepSeekSearchLlmRequest {
    /** Fully resolved Messages endpoint. */
    readonly endpoint: string;
    /** `anthropic-version` header value. */
    readonly apiVersion: string;
    /** Exact JSON body sent to the provider. */
    readonly body: {
        readonly model: string;
        readonly max_tokens: number;
        readonly messages: readonly [
            {
                readonly role: 'user';
                readonly content: readonly [
                    {
                        readonly type: 'text';
                        readonly text: string;
                    }
                ];
            }
        ];
        readonly tools: readonly [
            {
                readonly type: 'web_search_20250305';
                readonly name: 'web_search';
                readonly max_uses: number;
            }
        ];
    };
}
declare module '@deepseek-ai/dsh-session/types' {
    interface SessionEventMap {
        /** Secret-free auxiliary DeepSeek search request recorded before dispatch. */
        'web/deepseek-search-llm-request': DeepSeekSearchLlmRequest;
    }
}
/** Resolved provider options (the plugin's `apply` supplies credential and constant defaults). */
export interface DeepSeekSearchProviderOptions {
    /** Literal DeepSeek API key; when present it wins over {@link resolveApiKey}. */
    apiKey?: string;
    /** Resolve the current DeepSeek API key for one search operation. */
    resolveApiKey?: () => Promise<string | undefined>;
    /** Credential reference named by missing-credential diagnostics. */
    apiKeyEnv?: CredentialRef;
    /** Endpoint base; `/messages` is appended. */
    baseURL: string;
    /** Anthropic-format model name. */
    model: string;
    /** `anthropic-version` header value. */
    apiVersion: string;
    /** Upper bound on generated tokens for the Messages request. */
    maxTokens: number;
    /** Maximum `web_search` server-tool uses per request. */
    maxUses: number;
    /**
     * Record the exact secret-free request immediately before dispatch. A throw
     * prevents dispatch so model-visible auxiliary input cannot escape logging.
     */
    recordRequest?: (request: DeepSeekSearchLlmRequest) => void;
}
/**
 * Build a `url → cited_text` map from every `text` block's `citations[]`. This
 * is the snippet surface: Anthropic `web_search_result` items carry
 * `url`/`title`/`page_age` but typically NO inline snippet — the excerpt lives
 * in a separate `text` block's citation, keyed by `url` (first occurrence wins).
 *
 * @param blocks - the response's content blocks; non-`text` blocks are skipped.
 * @returns the `url → cited_text` map (empty when no citations are present).
 */
export declare function citationSnippets(blocks: readonly ContentBlock[]): Map<string, string>;
/**
 * Map a DeepSeek Anthropic Messages response to a normalized search result. Walks
 * `web_search_tool_result` blocks for citeable `web_search_result` items, joins each to its
 * citation excerpt as `snippet`, and dedupes by `url` (a `max_uses > 1` request can surface
 * the same URL across searches). The web service owns the final `maxResults` truncation, so
 * `truncated` is always `false` here.
 *
 * @param response - the parsed Messages response body.
 * @returns the normalized result with deduped, snippet-joined sources.
 * @throws {@link WebError} when native search produced no result block.
 */
export declare function mapAnthropicResponse(response: AnthropicResponse): WebSearchResult;
/** The DeepSeek-backed search provider; HTTP redirects fail as `WEB_PROVIDER_ERROR`. */
export declare class DeepSeekSearchProvider implements WebSearchProvider {
    private readonly options;
    readonly id = "deepseek-official";
    constructor(options: DeepSeekSearchProviderOptions);
    available(): boolean;
    search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
    /** Resolve one operation's credential without retaining it on the provider. */
    private apiKey;
}
//# sourceMappingURL=provider.d.ts.map