jeopi-cli 16.2.13 → 16.2.14

package/dist/types/web/search/providers/perplexity-auth.d.ts

@@ -1,37 +0,0 @@
-import type { AuthStorage, OAuthAccess } from "jeopi-ai";
-export declare const PERPLEXITY_CHAT_BASE_URL = "https://api.perplexity.ai";
-export declare const PERPLEXITY_RESPONSES_BASE_URL = "https://api.perplexity.ai/v1";
-export declare const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
-export declare const OAUTH_EXPIRY_BUFFER_MS: number;
-export interface ApiConfig {
-    type: "api_key";
-    apiKey: string;
-    provider: "perplexity" | "openrouter";
-    chatBaseUrl: string;
-    responsesBaseUrl: string;
-    modelPrefix: string;
-    useResponses: boolean;
-}
-export type PerplexityAuth = ApiConfig | {
-    type: "oauth";
-    access: OAuthAccess;
-} | {
-    type: "cookies";
-    cookies: string;
-} | {
-    type: "anonymous";
-};
-export interface PerplexityAuthOptions {
-    signal?: AbortSignal;
-    forceRefresh?: boolean;
-}
-/** Detect API-key endpoints to try in priority order (Perplexity direct, then OpenRouter). */
-export declare function getApiConfigs(authStorage: AuthStorage, sessionId: string | undefined, options?: PerplexityAuthOptions): Promise<ApiConfig[]>;
-/**
- * Decode a Perplexity JWT's `exp` claim, in ms. Returns `undefined` when the
- * token has no `exp` (which is the common case — Perplexity sessions are
- * server-side and effectively non-expiring from the client's POV).
- */
-export declare function jwtExpiryMs(token: string): number | undefined;
-/** Collect all available auth methods to try in priority order */
-export declare function getAvailableAuthMethods(authStorage: AuthStorage, sessionId: string | undefined, options?: PerplexityAuthOptions): Promise<PerplexityAuth[]>;

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

@@ -1,58 +0,0 @@
-/**
- * Perplexity Web Search Provider
- *
- * Supports four auth modes:
- * - Cookies (`PERPLEXITY_COOKIES`) via `www.perplexity.ai/rest/sse/perplexity_ask`
- * - OAuth/session bearer via `AuthStorage` and `www.perplexity.ai/rest/sse/perplexity_ask`
- * - API key (`PERPLEXITY_API_KEY`) via `api.perplexity.ai/chat/completions`
- * - Anonymous via `www.perplexity.ai/rest/sse/perplexity_ask`
- */
-import { type AuthStorage, type FetchImpl } from "jeopi-ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-export interface PerplexitySearchParams {
-    signal?: AbortSignal;
-    query: string;
-    system_prompt?: string;
-    search_recency_filter?: "hour" | "day" | "week" | "month" | "year";
-    num_results?: number;
-    /** Maximum output tokens. Defaults to 8192. */
-    max_tokens?: number;
-    /** Sampling temperature (0–1). Lower = more focused/factual. Defaults to 0.2. */
-    temperature?: number;
-    /** Number of search results to retrieve. Defaults to 20. */
-    num_search_results?: number;
-    authStorage: AuthStorage;
-    sessionId?: string;
-    fetch?: FetchImpl;
-}
-/** Execute Perplexity web search */
-export declare function searchPerplexity(params: PerplexitySearchParams): Promise<SearchResponse>;
-/** Search provider for Perplexity. */
-export declare class PerplexityProvider extends SearchProvider {
-    readonly id = "perplexity";
-    readonly label = "Perplexity";
-    /**
-     * Auto-chain admission. Requires a direct Perplexity credential
-     * (`PERPLEXITY_COOKIES`, OAuth session, or `PERPLEXITY_API_KEY`).
-     *
-     * OpenRouter auth is intentionally NOT accepted here: silently using
-     * OpenRouter's `perplexity/sonar-pro` whenever any OpenRouter key is
-     * configured surprises users (and bills them) for a path they never
-     * asked for. The auto chain skips Perplexity in that case and falls
-     * through to the next configured provider. Users who DO want the
-     * OpenRouter-backed Perplexity path can still opt in by setting
-     * `webSearch: perplexity` explicitly — see {@link isExplicitlyAvailable}.
-     */
-    isAvailable(authStorage: AuthStorage): boolean;
-    /**
-     * Perplexity accepts anonymous browser-style ask requests, and the
-     * OpenRouter-backed `perplexity/sonar-pro` path is opt-in through
-     * explicit selection. Keep auto-chain admission credential-gated so a
-     * configured provider keeps priority over the anonymous/OpenRouter
-     * fallbacks.
-     */
-    isExplicitlyAvailable(_authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

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

@@ -1,45 +0,0 @@
-/**
- * SearXNG Web Search Provider
- *
- * Calls a SearXNG instance's JSON search API and maps results into the unified
- * SearchResponse shape used by the web search tool.
- *
- * SearXNG is a free, open-source metasearch engine that aggregates results from
- * multiple sources without tracking users. It supports self-hosted instances
- * and various authentication methods (bearer token, basic auth, or none).
- *
- * Configuration via settings:
- *   searxng.endpoint      - Base URL of the SearXNG instance (e.g. https://searx.example.org)
- *   searxng.token         - Optional bearer token for authentication
- *   searxng.basicUsername - Optional RFC 7617 Basic auth username
- *   searxng.basicPassword - Optional RFC 7617 Basic auth password
- *   searxng.categories    - Optional comma-separated categories filter
- *   searxng.language      - Optional language code (e.g. en, zh-CN)
- *
- * Environment variable fallbacks:
- *   SEARXNG_ENDPOINT       - Base URL of the SearXNG instance
- *   SEARXNG_TOKEN          - Optional bearer token
- *   SEARXNG_BASIC_USERNAME - Optional RFC 7617 Basic auth username
- *   SEARXNG_BASIC_PASSWORD - Optional RFC 7617 Basic auth password
- *
- * Reference: https://docs.searxng.org/dev/search_api.html
- */
-import type { AuthStorage, FetchImpl } from "jeopi-ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-/** Execute SearXNG web search. */
-export declare function searchSearXNG(params: {
-    query: string;
-    num_results?: number;
-    recency?: "day" | "week" | "month" | "year";
-    signal?: AbortSignal;
-    fetch?: FetchImpl;
-}): Promise<SearchResponse>;
-/** Search provider for SearXNG web search. */
-export declare class SearXNGProvider extends SearchProvider {
-    readonly id = "searxng";
-    readonly label = "SearXNG";
-    isAvailable(_authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

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

@@ -1,25 +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, type FetchImpl } from "jeopi-ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-type SearchParamsWithFetch = SearchParams & {
-    fetch?: FetchImpl;
-};
-/** 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: SearchParamsWithFetch): Promise<SearchResponse>;
-/** Search provider for Synthetic. */
-export declare class SyntheticProvider extends SearchProvider {
-    readonly id = "synthetic";
-    readonly label = "Synthetic";
-    isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParamsWithFetch): Promise<SearchResponse>;
-}
-export {};

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

@@ -1,30 +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, type FetchImpl } from "jeopi-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;
-    fetch?: FetchImpl;
-}
-/** 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/tinyfish.d.ts

@@ -1,29 +0,0 @@
-/**
- * TinyFish Web Search Provider
- *
- * Calls TinyFish's search API and maps results into the unified
- * SearchResponse shape used by the web search tool.
- */
-import { type AuthStorage, type FetchImpl } from "jeopi-ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-export interface TinyFishSearchParams {
-    query: string;
-    num_results?: number;
-    recency?: SearchParams["recency"];
-    page?: number;
-    signal?: AbortSignal;
-    fetch?: FetchImpl;
-}
-/** Resolve TinyFish API key through the shared auth storage pipeline. */
-export declare function findApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | undefined>;
-/** Execute TinyFish web search. */
-export declare function searchTinyFish(params: SearchParams): Promise<SearchResponse>;
-/** Search provider for TinyFish web search. */
-export declare class TinyFishProvider extends SearchProvider {
-    readonly id = "tinyfish";
-    readonly label = "TinyFish";
-    isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

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

@@ -1,52 +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;
-/**
- * Default hard ceiling for a single web-search round-trip. 60s tolerates
- * legitimate slow LLM-mediated responses (anthropic web_search_20250305,
- * perplexity, gemini, codex) while still guaranteeing the session unfreezes
- * within a minute if Bun's `AbortSignal` fails to propagate on Windows.
- *
- * Pure search APIs (brave, exa, jina, tavily, searxng, synthetic, zai)
- * settle far faster in practice; reusing the same ceiling keeps the wiring
- * uniform without compromising correctness.
- */
-export declare const SEARCH_HARD_TIMEOUT_MS = 60000;
-/**
- * Compose a caller-supplied {@link AbortSignal} with a hard timeout so an
- * outbound `fetch()` is guaranteed to settle within `ms` 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 ms - Hard timeout in milliseconds. Defaults to {@link SEARCH_HARD_TIMEOUT_MS}.
- */
-export declare function withHardTimeout(signal: AbortSignal | undefined, ms?: number): 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,13 +0,0 @@
-import { type AuthStorage } from "jeopi-ai";
-import type { SearchResponse } from "../../../web/search/types";
-import type { SearchParams } from "./base";
-import { SearchProvider } from "./base";
-/** Execute xAI Responses API web search. */
-export declare function searchXAI(params: SearchParams): Promise<SearchResponse>;
-/** Search provider for xAI web search. */
-export declare class XAIProvider extends SearchProvider {
-    readonly id = "xai";
-    readonly label = "xAI";
-    isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
-}

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

@@ -1,29 +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, type FetchImpl } from "jeopi-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;
-    fetch?: FetchImpl;
-    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,34 +0,0 @@
-/**
- * Web Search TUI Rendering
- *
- * Tree-based rendering with collapsed/expanded states for web search results.
- */
-import type { Component } from "jeopi-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;
-}
-/** 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;
-    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;
-};