@oh-my-pi/pi-coding-agent 15.1.0 → 15.1.2

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

@@ -0,0 +1,344 @@
+/**
+ * Web Search Types
+ *
+ * Unified types for web search responses across supported providers.
+ */
+/** Supported web search providers */
+export type SearchProviderId = "exa" | "brave" | "jina" | "kimi" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "tavily" | "parallel" | "kagi" | "synthetic" | "searxng";
+export declare function isSearchProviderId(value: string): value is SearchProviderId;
+export declare function isSearchProviderPreference(value: string): value is SearchProviderId | "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;
+    /** Anthropic: number of web search requests made */
+    searchRequests?: 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;
+}
+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 (for type="web_search_tool_result") */
+    content?: AnthropicSearchResult[];
+}
+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

@@ -0,0 +1,4 @@
+/** 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;

package/dist/types/workspace-tree.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Hard cap on AGENTS.md files surfaced by `buildWorkspaceTree`. Mirrors the
+ * native cap so the system-prompt builder does not need a second pass.
+ */
+export declare const AGENTS_MD_LIMIT = 200;
+export interface DirectoryTree {
+    rootPath: string;
+    rendered: string;
+    truncated: boolean;
+    totalLines: number;
+}
+export interface WorkspaceTree extends DirectoryTree {
+    /** AGENTS.md files beneath the root whose rules may apply to subdirectories. */
+    agentsMdFiles: string[];
+}
+export interface BuildDirectoryTreeOptions {
+    /** Directory depth below the root to include. Root itself is depth 0. Default: 1. */
+    maxDepth?: number;
+    /** Per-directory child cap. `null` disables the cap. Default: `null`. */
+    perDirLimit?: number | null;
+    /** Optional override for the root level. Defaults to `perDirLimit`. */
+    rootLimit?: number | null;
+    /** Hard rendered line cap. `null` disables. Default: `null`. */
+    lineCap?: number | null;
+}
+export interface BuildWorkspaceTreeOptions {
+    /** Abort the native workspace scan after this many milliseconds. */
+    timeoutMs?: number;
+}
+/**
+ * Build a generic directory tree using a single native scan. Hidden files are
+ * shown, .gitignore is not consulted, and the standard non-source directories
+ * (`node_modules`, `.git`, build outputs, caches…) are pruned by the native
+ * walker. Used by the read tool's directory-listing path.
+ */
+export declare function buildDirectoryTree(cwd: string, options?: BuildDirectoryTreeOptions): Promise<DirectoryTree>;
+/**
+ * Build the workspace tree shown in the system prompt. Returns the rendered
+ * tree plus the AGENTS.md files surfaced by the same native walk so callers
+ * never need to do a second filesystem scan.
+ */
+export declare function buildWorkspaceTree(cwd: string, options?: BuildWorkspaceTreeOptions): Promise<WorkspaceTree>;