@sayknow-cli/coding-agent 0.3.12 → 0.3.13

package/dist/types/web/search/providers/synthetic.d.ts

@@ -1,21 +0,0 @@
-/**
- * Synthetic Web Search Provider
- *
- * Uses Synthetic's zero-data-retention web search API for coding agents.
- * Endpoint: POST https://api.synthetic.new/v2/search
- */
-import { type AuthStorage } from "@sayknow-cli/ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-/** Resolve Synthetic API key through the shared auth storage pipeline. */
-export declare function findApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | undefined>;
-/** Execute Synthetic web search. */
-export declare function searchSynthetic(params: SearchParams): Promise<SearchResponse>;
-/** Search provider for Synthetic. */
-export declare class SyntheticProvider extends SearchProvider {
-    readonly id = "synthetic";
-    readonly label = "Synthetic";
-    isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

package/dist/types/web/search/providers/tavily.d.ts

@@ -1,29 +0,0 @@
-/**
- * Tavily Web Search Provider
- *
- * Uses Tavily's agent-focused search API to return structured results with an
- * optional synthesized answer.
- */
-import { type AuthStorage } from "@sayknow-cli/ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-export interface TavilySearchParams {
-    query: string;
-    num_results?: number;
-    recency?: "day" | "week" | "month" | "year";
-    signal?: AbortSignal;
-}
-/** Find Tavily API key through AuthStorage's unified refresh pipeline. */
-export declare function findApiKey(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<string | null>;
-/** Exported for testing. Builds the Tavily request body from unified params. */
-export declare function buildRequestBody(params: TavilySearchParams): Record<string, unknown>;
-/** Execute Tavily web search. */
-export declare function searchTavily(params: SearchParams): Promise<SearchResponse>;
-/** Search provider for Tavily web search. */
-export declare class TavilyProvider extends SearchProvider {
-    readonly id = "tavily";
-    readonly label = "Tavily";
-    isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

package/dist/types/web/search/providers/text-citations.d.ts

@@ -1,23 +0,0 @@
-/**
- * Inline citation extraction shared by native web-search providers.
- *
- * Web-search-capable models sometimes return a genuinely grounded answer whose
- * sources are written inline (markdown links or bare URLs) instead of as
- * structured citation annotations. When a provider has independent proof that a
- * web search actually ran, these helpers recover sources from the answer text so
- * the result is not discarded.
- */
-import type { SearchSource } from "../types";
-/** Append a source, de-duplicating by URL. */
-export declare function addSource(sources: SearchSource[], source: SearchSource): void;
-/**
- * Strips prose punctuation and unmatched closing delimiters from extracted URLs.
- * Models often return links embedded in markdown or sentence text.
- */
-export declare function normalizeExtractedUrl(candidate: string): string | null;
-/**
- * Extracts citation sources from markdown links and bare URLs in answer text.
- * Used only as a fallback when a provider confirms a search ran but omits
- * structured citation annotations.
- */
-export declare function extractTextSources(text: string): SearchSource[];

package/dist/types/web/search/providers/utils.d.ts

@@ -1,88 +0,0 @@
-import type { AgentStorage } from "../../../session/agent-storage";
-import { SearchProviderError, type SearchProviderId, type SearchSource } from "../../../web/search/types";
-/**
- * Search for an API credential by checking an env-derived key first,
- * then falling back to agent.db stored credentials for the given providers.
- *
- * The caller MUST supply an open {@link AgentStorage} handle so the helper
- * never reaches out to global filesystem state; both the unified web_search
- * chain and one-shot CLI calls open storage exactly once and thread it
- * through every provider.
- *
- * @param storage - Open agent storage handle
- * @param envKey - Pre-resolved environment variable value (or null)
- * @param storageProviders - Provider names to look up in AgentStorage
- */
-export declare function findCredential(storage: AgentStorage | null | undefined, envKey: string | null | undefined, ...storageProviders: string[]): string | null;
-/**
- * Legacy hard ceiling for a single web-search round-trip, retained as the
- * fallback for call sites that do not declare a timeout class. 300s tolerates
- * pathological cases while still guaranteeing the session unfreezes if Bun's
- * `AbortSignal` fails to propagate on Windows.
- */
-export declare const SEARCH_HARD_TIMEOUT_MS = 300000;
-/**
- * Hard ceiling for pure search APIs (brave, exa, jina, tavily, kagi,
- * parallel, searxng, synthetic, zai, duckduckgo). These settle in ~1-3s in
- * practice; a hung TCP/TLS connection should fall through to the next
- * provider in seconds, not minutes. Kimi is the exception: it declares an
- * explicit ceiling aligned with its upstream 30s request budget.
- */
-export declare const SEARCH_API_TIMEOUT_MS = 15000;
-/**
- * Hard ceiling for LLM-mediated search providers (anthropic, codex, gemini,
- * perplexity, xai, openai-compatible). These legitimately take tens of
- * seconds because a model performs the search and synthesizes an answer.
- */
-export declare const SEARCH_LLM_TIMEOUT_MS = 120000;
-/** Timeout class a provider declares for its outbound round-trips. */
-export type SearchTimeoutClass = "api" | "llm";
-/**
- * Override the hard timeout applied to every web-search round-trip.
- *
- * @param ms - Hard timeout in milliseconds. Non-finite or non-positive
- *   values clear the override so per-class defaults apply.
- */
-export declare function setSearchHardTimeoutMs(ms: number | undefined): void;
-/** Structural settings source for {@link applyConfiguredSearchTimeout}. */
-export interface SearchTimeoutSettingSource {
-    get(path: "web_search.timeout"): unknown;
-    has(path: "web_search.timeout"): boolean;
-}
-/**
- * Install the `web_search.timeout` override from settings — but only when the
- * user explicitly configured it. The settings schema ships a default value
- * (300), and consuming that default via `get()` alone would reinstall a
- * uniform 300s ceiling on every session, silently disabling the per-class
- * timeout defaults. `has()` distinguishes loaded/overridden settings from
- * schema defaults; unset clears any previous override so class defaults apply.
- */
-export declare function applyConfiguredSearchTimeout(settings: SearchTimeoutSettingSource): void;
-/**
- * Compose a caller-supplied {@link AbortSignal} with a hard timeout so an
- * outbound `fetch()` is guaranteed to settle even when the runtime fails to
- * propagate cancellation to the underlying transport.
- *
- * Bun's WinHTTP backend on Windows is known to ignore `AbortSignal` once a
- * TCP/TLS connection stalls (oven-sh/bun#15275, oven-sh/bun#18536); without
- * this safety net a stalled web-search request freezes the entire session
- * because the user's Esc is never delivered to the native layer.
- *
- * @param signal - Caller cancellation signal, if any.
- * @param msOrClass - Explicit timeout in milliseconds, or a
- *   {@link SearchTimeoutClass} resolved to its class default. Omitted falls
- *   back to the legacy {@link SEARCH_HARD_TIMEOUT_MS} ceiling. A user-set
- *   `web_search.timeout` overrides class defaults (but not explicit ms).
- */
-export declare function withHardTimeout(signal: AbortSignal | undefined, msOrClass?: number | SearchTimeoutClass): AbortSignal;
-/**
- * Map a provider's raw source list to the unified SearchSource shape,
- * clamped to the requested result count and annotated with ageSeconds.
- */
-export declare function toSearchSources(sources: ReadonlyArray<{
-    title: string;
-    url: string;
-    snippet?: string;
-    publishedDate?: string;
-}>, numResults: number): SearchSource[];
-export declare function classifyProviderHttpError(provider: SearchProviderId, status: number, body: string): SearchProviderError | null;

package/dist/types/web/search/providers/xai.d.ts

@@ -1,64 +0,0 @@
-/**
- * xAI Web/X Search Provider
- *
- * Uses xAI's Responses API with the built-in web_search and x_search tools.
- * Endpoint: POST https://api.x.ai/v1/responses
- */
-import type { AuthStorage } from "@sayknow-cli/ai";
-import type { SearchCitation, SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-declare const XAI_SEARCH_MODES: readonly ["web", "x", "web_and_x"];
-export type XaiSearchMode = (typeof XAI_SEARCH_MODES)[number];
-export interface XaiSearchParams {
-    query: string;
-    system_prompt?: string;
-    num_results?: number;
-    max_output_tokens?: number;
-    temperature?: number;
-    recency?: "day" | "week" | "month" | "year";
-    xai_search_mode?: XaiSearchMode;
-    allowed_domains?: string[];
-    excluded_domains?: string[];
-    allowed_x_handles?: string[];
-    excluded_x_handles?: string[];
-    from_date?: string;
-    to_date?: string;
-    enable_image_understanding?: boolean;
-    enable_image_search?: boolean;
-    enable_video_understanding?: boolean;
-    no_inline_citations?: boolean;
-    signal?: AbortSignal;
-    authStorage: AuthStorage;
-    sessionId?: string;
-}
-export declare function buildXaiRequestBody(params: {
-    query: string;
-    systemPrompt: string;
-    model: string;
-    maxOutputTokens?: number;
-    temperature?: number;
-    recency?: XaiSearchParams["recency"];
-    xaiSearchMode?: XaiSearchMode;
-    allowedDomains?: string[];
-    excludedDomains?: string[];
-    allowedXHandles?: string[];
-    excludedXHandles?: string[];
-    fromDate?: string;
-    toDate?: string;
-    enableImageUnderstanding?: boolean;
-    enableImageSearch?: boolean;
-    enableVideoUnderstanding?: boolean;
-    noInlineCitations?: boolean;
-}): Record<string, unknown>;
-export declare function parseXaiCitations(json: any): SearchCitation[];
-/** Execute xAI web/X search through the Responses API search tools. */
-export declare function searchXai(params: XaiSearchParams): Promise<SearchResponse>;
-/** Search provider for xAI web and X search. */
-export declare class XaiProvider extends SearchProvider {
-    readonly id = "xai";
-    readonly label = "xAI";
-    isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}
-export {};

package/dist/types/web/search/providers/zai.d.ts

@@ -1,28 +0,0 @@
-/**
- * Z.AI Web Search Provider
- *
- * Calls Z.AI's remote MCP server (`webSearchPrime`) and adapts results into
- * the unified SearchResponse shape used by the web search tool.
- */
-import { type AuthStorage } from "@sayknow-cli/ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-export interface ZaiSearchParams {
-    query: string;
-    num_results?: number;
-    signal?: AbortSignal;
-    authStorage: AuthStorage;
-    sessionId?: string;
-}
-/** Resolve Z.AI API credentials through the unified auth storage pipeline. */
-export declare function findApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | null>;
-/** Execute Z.AI web search via remote MCP endpoint. */
-export declare function searchZai(params: ZaiSearchParams): Promise<SearchResponse>;
-/** Search provider for Z.AI web search MCP. */
-export declare class ZaiProvider extends SearchProvider {
-    readonly id = "zai";
-    readonly label = "Z.AI";
-    isAvailable(authStorage: AuthStorage): Promise<boolean> | boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

package/dist/types/web/search/render.d.ts

@@ -1,36 +0,0 @@
-/**
- * Web Search TUI Rendering
- *
- * Tree-based rendering with collapsed/expanded states for web search results.
- */
-import type { Component } from "@sayknow-cli/tui";
-import type { RenderResultOptions } from "../../extensibility/custom-tools/types";
-import type { Theme } from "../../modes/theme/theme";
-import type { SearchResponse } from "./types";
-export interface SearchRenderDetails {
-    response: SearchResponse;
-    error?: string;
-    warning?: string;
-}
-/** Render web search result with tree-based layout */
-export declare function renderSearchResult(result: {
-    content: Array<{
-        type: string;
-        text?: string;
-    }>;
-    details?: SearchRenderDetails;
-}, options: RenderResultOptions, theme: Theme, args?: {
-    query?: string;
-    allowLongAnswer?: boolean;
-    maxAnswerLines?: number;
-}): Component;
-/** Render web search call (query preview) */
-export declare function renderSearchCall(args: {
-    query?: string;
-    [key: string]: unknown;
-}, _options: RenderResultOptions, theme: Theme): Component;
-export declare const webSearchToolRenderer: {
-    renderCall: typeof renderSearchCall;
-    renderResult: typeof renderSearchResult;
-    mergeCallAndResult: boolean;
-};

package/dist/types/web/search/types.d.ts

@@ -1,372 +0,0 @@
-/**
- * Web Search Types
- *
- * Unified types for web search responses across supported providers.
- */
-/** Supported web search providers */
-export type SearchProviderId = "duckduckgo" | "insane" | "exa" | "brave" | "jina" | "kimi" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "xai" | "tavily" | "parallel" | "kagi" | "synthetic" | "searxng" | "openai-compatible";
-export type WebSearchMode = "on" | "off" | "auto";
-export interface ActiveSearchModelContext {
-    provider: string;
-    modelId: string;
-    wireModelId?: string;
-    api: string;
-    baseUrl?: string;
-    headers?: Record<string, string>;
-    webSearch?: WebSearchMode;
-}
-export declare const CONFIGURABLE_SEARCH_PROVIDER_IDS: readonly ["duckduckgo", "insane", "exa", "brave", "jina", "kimi", "zai", "anthropic", "perplexity", "gemini", "codex", "xai", "tavily", "parallel", "kagi", "synthetic", "searxng"];
-export declare function isSearchProviderId(value: string): value is SearchProviderId;
-export declare function isConfigurableSearchProviderId(value: string): value is (typeof CONFIGURABLE_SEARCH_PROVIDER_IDS)[number];
-export declare function isSearchProviderPreference(value: string): value is (typeof CONFIGURABLE_SEARCH_PROVIDER_IDS)[number] | "auto";
-/** Source returned by search (all providers) */
-export interface SearchSource {
-    title: string;
-    url: string;
-    snippet?: string;
-    /** ISO date string or relative ("2d ago") */
-    publishedDate?: string;
-    /** Age in seconds for consistent formatting */
-    ageSeconds?: number;
-    author?: string;
-}
-/** Citation with text reference (anthropic, perplexity) */
-export interface SearchCitation {
-    url: string;
-    title: string;
-    citedText?: string;
-}
-/** Usage metrics */
-export interface SearchUsage {
-    inputTokens?: number;
-    outputTokens?: number;
-    /** Number of web search requests made */
-    searchRequests?: number;
-    /** Number of xAI X Search requests made */
-    xSearchRequests?: number;
-    /** Number of image search requests made */
-    imageSearchRequests?: number;
-    /** Number of image-understanding/view-image requests made */
-    imageUnderstandingRequests?: number;
-    /** Number of video-understanding requests made */
-    videoUnderstandingRequests?: number;
-    /** Perplexity: combined token count */
-    totalTokens?: number;
-}
-/** Unified response across providers */
-export interface SearchResponse {
-    provider: SearchProviderId | "none";
-    /** Synthesized answer text (anthropic, perplexity) */
-    answer?: string;
-    /** Search result sources */
-    sources: SearchSource[];
-    /** Text citations with context */
-    citations?: SearchCitation[];
-    /** Intermediate search queries (anthropic) */
-    searchQueries?: string[];
-    /** Follow-up question suggestions (provider-dependent) */
-    relatedQuestions?: string[];
-    /** Token usage metrics */
-    usage?: SearchUsage;
-    /** Model used */
-    model?: string;
-    /** Request ID for debugging */
-    requestId?: string;
-    /** Authentication mode used by the provider (e.g. oauth, api-key) */
-    authMode?: string;
-}
-/** Provider-specific error with optional HTTP status */
-export declare class SearchProviderError extends Error {
-    readonly provider: SearchProviderId;
-    readonly status?: number | undefined;
-    constructor(provider: SearchProviderId, message: string, status?: number | undefined);
-}
-/** Anthropic API response types */
-export interface AnthropicSearchResult {
-    type: "web_search_result";
-    title: string;
-    url: string;
-    encrypted_content: string;
-    page_age: string | null;
-}
-export interface AnthropicCitation {
-    type: "web_search_result_location";
-    url: string;
-    title: string;
-    cited_text: string;
-    encrypted_index: string;
-}
-/**
- * Error payload returned in `web_search_tool_result.content` when a server-side
- * web search fails. Unlike the success case, this is an object, not an array.
- */
-export interface AnthropicWebSearchToolResultError {
-    type: "web_search_tool_result_error";
-    error_code?: string;
-}
-export interface AnthropicContentBlock {
-    type: string;
-    /** Text content (for type="text") */
-    text?: string;
-    /** Citations in text block */
-    citations?: AnthropicCitation[];
-    /** Tool name (for type="server_tool_use") */
-    name?: string;
-    /** Tool input (for type="server_tool_use") */
-    input?: {
-        query: string;
-    };
-    /** Search results array on success, or an error object on failure (type="web_search_tool_result") */
-    content?: AnthropicSearchResult[] | AnthropicWebSearchToolResultError;
-}
-export interface AnthropicApiResponse {
-    id: string;
-    model: string;
-    content: AnthropicContentBlock[];
-    usage: {
-        input_tokens: number;
-        output_tokens: number;
-        cache_read_input_tokens?: number;
-        cache_creation_input_tokens?: number;
-        server_tool_use?: {
-            web_search_requests: number;
-        };
-    };
-}
-/** Perplexity API types */
-export type PerplexityChatMessageRole = "system" | "user" | "assistant" | "tool";
-export interface PerplexityUrl {
-    url: string;
-}
-export interface PerplexityVideoUrl {
-    url: string;
-    frame_interval?: string | number;
-}
-export interface PerplexityContentTextChunk {
-    type: "text";
-    text: string;
-}
-export interface PerplexityContentImageChunk {
-    type: "image_url";
-    image_url: PerplexityUrl | string;
-}
-export interface PerplexityContentFileChunk {
-    type: "file_url";
-    file_url: PerplexityUrl | string;
-    file_name?: string | null;
-}
-export interface PerplexityContentPdfChunk {
-    type: "pdf_url";
-    pdf_url: PerplexityUrl | string;
-}
-export interface PerplexityContentVideoChunk {
-    type: "video_url";
-    video_url: PerplexityVideoUrl | string;
-}
-export type PerplexityContentChunk = PerplexityContentTextChunk | PerplexityContentImageChunk | PerplexityContentFileChunk | PerplexityContentPdfChunk | PerplexityContentVideoChunk;
-export interface PerplexitySearchStepDetails {
-    search_results: PerplexitySearchResult[];
-    search_keywords: string[];
-}
-export interface PerplexityFetchUrlContentStepDetails {
-    contents: PerplexitySearchResult[];
-}
-export interface PerplexityExecutePythonStepDetails {
-    code: string;
-    result: string;
-}
-export interface PerplexityReasoningStepInput {
-    thought: string;
-    type?: string | null;
-    web_search?: PerplexitySearchStepDetails | null;
-    fetch_url_content?: PerplexityFetchUrlContentStepDetails | null;
-    execute_python?: PerplexityExecutePythonStepDetails | null;
-}
-export interface PerplexityReasoningStepOutput {
-    thought: string;
-    type?: string | null;
-    web_search?: PerplexitySearchStepDetails | null;
-    fetch_url_content?: PerplexityFetchUrlContentStepDetails | null;
-    execute_python?: PerplexityExecutePythonStepDetails | null;
-}
-export interface PerplexityToolCallFunction {
-    name?: string | null;
-    arguments?: string | null;
-}
-export interface PerplexityToolCall {
-    id?: string | null;
-    type?: "function" | null;
-    function?: PerplexityToolCallFunction | null;
-}
-export interface PerplexityMessageInput {
-    role: PerplexityChatMessageRole;
-    content: string | PerplexityContentChunk[] | null;
-    reasoning_steps?: PerplexityReasoningStepInput[] | null;
-    tool_calls?: PerplexityToolCall[] | null;
-    tool_call_id?: string | null;
-}
-export interface PerplexityMessageOutput {
-    role: PerplexityChatMessageRole;
-    content: string | PerplexityContentChunk[] | null;
-    reasoning_steps?: PerplexityReasoningStepOutput[] | null;
-    tool_calls?: PerplexityToolCall[] | null;
-    tool_call_id?: string | null;
-}
-export type PerplexityMessage = PerplexityMessageInput;
-export interface PerplexityResponseFormatText {
-    type: "text";
-}
-export interface PerplexityJSONSchema {
-    schema: Record<string, unknown>;
-    name?: string | null;
-    description?: string | null;
-    strict?: boolean | null;
-}
-export interface PerplexityResponseFormatJSONSchema {
-    type: "json_schema";
-    json_schema: PerplexityJSONSchema;
-}
-export interface PerplexityRegexSchema {
-    regex: string;
-    name?: string | null;
-    description?: string | null;
-    strict?: boolean | null;
-}
-export interface PerplexityResponseFormatRegex {
-    type: "regex";
-    regex: PerplexityRegexSchema;
-}
-export type PerplexityResponseFormat = PerplexityResponseFormatText | PerplexityResponseFormatJSONSchema | PerplexityResponseFormatRegex;
-export interface PerplexityParameterSpec {
-    type: string;
-    properties: Record<string, unknown>;
-    required?: string[] | null;
-    additional_properties?: boolean | null;
-}
-export interface PerplexityFunctionSpec {
-    name: string;
-    description: string;
-    parameters: PerplexityParameterSpec;
-    strict?: boolean | null;
-}
-export interface PerplexityToolSpec {
-    type: "function";
-    function: PerplexityFunctionSpec;
-}
-export interface PerplexityUserLocation {
-    latitude?: number | null;
-    longitude?: number | null;
-    country?: string | null;
-    city?: string | null;
-    region?: string | null;
-}
-export interface PerplexitySearchOptions {
-    search_context_size?: "low" | "medium" | "high";
-    search_type?: "fast" | "pro" | "auto" | null;
-    user_location?: PerplexityUserLocation | null;
-    image_results_enhanced_relevance?: boolean;
-}
-export interface PerplexityRequest {
-    max_tokens?: number | null;
-    temperature?: number | null;
-    n?: number | null;
-    model: string;
-    stream?: boolean | null;
-    stop?: string | string[] | null;
-    cum_logprobs?: boolean | null;
-    logprobs?: boolean | null;
-    top_logprobs?: number | null;
-    best_of?: number | null;
-    response_metadata?: Record<string, unknown> | null;
-    response_format?: PerplexityResponseFormat | null;
-    diverse_first_token?: boolean | null;
-    _inputs?: number[] | null;
-    _prompt_token_length?: number | null;
-    messages: PerplexityMessageInput[];
-    tools?: PerplexityToolSpec[] | null;
-    tool_choice?: "none" | "auto" | "required" | null;
-    parallel_tool_calls?: boolean | null;
-    web_search_options?: PerplexitySearchOptions;
-    search_mode?: "web" | "academic" | "sec" | null;
-    return_images?: boolean | null;
-    return_related_questions?: boolean | null;
-    num_search_results?: number;
-    num_images?: number;
-    enable_search_classifier?: boolean | null;
-    disable_search?: boolean | null;
-    search_domain_filter?: string[] | null;
-    search_language_filter?: string[] | null;
-    search_tenant?: string | null;
-    ranking_model?: string | null;
-    latitude?: number | null;
-    longitude?: number | null;
-    country?: string | null;
-    search_recency_filter?: "hour" | "day" | "week" | "month" | "year" | null;
-    search_after_date_filter?: string | null;
-    search_before_date_filter?: string | null;
-    last_updated_before_filter?: string | null;
-    last_updated_after_filter?: string | null;
-    image_format_filter?: string[] | null;
-    image_domain_filter?: string[] | null;
-    safe_search?: boolean | null;
-    file_workspace_id?: string | null;
-    updated_before_timestamp?: number | null;
-    updated_after_timestamp?: number | null;
-    search_internal_properties?: Record<string, unknown> | null;
-    use_threads?: boolean | null;
-    thread_id?: string | null;
-    stream_mode?: "full" | "concise";
-    _debug_pro_search?: boolean;
-    has_image_url?: boolean;
-    reasoning_effort?: "minimal" | "low" | "medium" | "high" | null;
-    language_preference?: string | null;
-    user_original_query?: string | null;
-    _force_new_agent?: boolean | null;
-}
-export interface PerplexitySearchResult {
-    title: string;
-    url: string;
-    date?: string | null;
-    last_updated?: string | null;
-    snippet?: string;
-    source?: "web" | "attachment";
-}
-export interface PerplexityCost {
-    input_tokens_cost: number;
-    output_tokens_cost: number;
-    reasoning_tokens_cost?: number | null;
-    request_cost?: number | null;
-    citation_tokens_cost?: number | null;
-    search_queries_cost?: number | null;
-    total_cost: number;
-}
-export interface PerplexityUsageInfo {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-    search_context_size?: string | null;
-    citation_tokens?: number | null;
-    num_search_queries?: number | null;
-    reasoning_tokens?: number | null;
-    cost: PerplexityCost;
-}
-export type PerplexityCompletionResponseType = "message" | "info" | "end_of_stream";
-export type PerplexityCompletionResponseStatus = "PENDING" | "COMPLETED";
-export interface PerplexityChoice {
-    index: number;
-    finish_reason?: "stop" | "length" | null;
-    message: PerplexityMessageOutput;
-    delta: PerplexityMessageOutput;
-}
-export interface PerplexityResponse {
-    id: string;
-    model: string;
-    created: number;
-    usage?: PerplexityUsageInfo | null;
-    object?: string;
-    choices: PerplexityChoice[];
-    citations?: string[] | null;
-    search_results?: PerplexitySearchResult[] | null;
-    type?: PerplexityCompletionResponseType | null;
-    status?: PerplexityCompletionResponseStatus | null;
-}

package/dist/types/web/search/utils.d.ts

@@ -1,4 +0,0 @@
-/** Calculate age in seconds from an ISO date string. Returns undefined on invalid input. */
-export declare function dateToAgeSeconds(dateStr: string | null | undefined): number | undefined;
-/** Clamp a result count to [1, maxVal], returning defaultVal when value is absent or NaN. */
-export declare function clampNumResults(value: number | undefined, defaultVal: number, maxVal: number): number;