interface CoolhandOptions {
    apiKey: string;
    silent?: boolean;
    patternsFile?: string;
    debug?: boolean;
    dryRun?: boolean;
    baseUrl?: string;
    excludeApiPatterns?: string[];
    /** @deprecated Use `baseUrl` instead. Removed in v0.4.0; shim will be removed after v1.x.x. */
    environment?: 'local' | 'production';
}
interface CoolhandCallData {
    id: number;
    timestamp: string;
    method: string;
    url: string;
    headers: Record<string, any>;
    request_body: any;
    response_body: any;
    response_headers: Record<string, any> | null;
    status_code: number | null;
    protocol: string;
}
interface CoolhandStats {
    totalRequests: number;
    interceptedCalls: number;
    apiEndpoint: string;
}
interface CoolhandRequestOptions {
    hostname?: string;
    host?: string;
    port?: number;
    path?: string;
    method?: string;
    headers?: Record<string, any>;
    href?: string;
    url?: string;
    auth?: string;
}
interface CoolhandLogPayload {
    llm_request_log: {
        raw_request: CoolhandCallData;
        collector?: string;
        metadata?: Record<string, unknown>;
    };
}
interface CoolhandLogResponse {
    /**
     * A raw integer database ID today; becomes a hashid string once
     * Coolhand-Labs/coolhand#1096 ships (its blueprint change applies to `create`'s response too,
     * not just `index`/`show` — see docs/log-search.md's "IDs" note). Widened ahead of that so this
     * type doesn't need another breaking change when it happens.
     */
    id?: number | string;
    source_api?: string | null;
    source_api_result?: string | null;
    llm_provider_unique_id?: string | null;
    warnings?: string[];
    metadata?: Record<string, unknown> | null;
    [key: string]: unknown;
}
interface CoolhandClientFilePayload {
    name: string;
    file_type?: 'slide_deck' | 'report' | 'document';
    description?: string;
    file: Buffer | Blob;
    filename: string;
    metadata?: Record<string, unknown>;
}
interface CoolhandClientFileResponse {
    id: string;
    name: string;
    file_type: string;
    status: string;
    description: string | null;
    metadata: Record<string, unknown>;
    created_at: string;
}
interface CoolhandAPIPattern {
    id?: string;
    name: string;
    domains: string[];
    paths?: string[];
    /** Allow `paths` to match regardless of hostname (e.g. a self-hosted proxy under an
     *  unrelated domain). Off by default — a wrong opt-in lets unrelated hosts sharing a
     *  common path fragment (e.g. `/v1/models`) be captured and forwarded to Coolhand. */
    allowPathMatchAcrossDomains?: boolean;
    headers?: Record<string, string>;
}
interface CoolhandAPIPatterns {
    patterns: CoolhandAPIPattern[];
}
interface CoolhandMatchedPattern {
    pattern: CoolhandAPIPattern;
    matchType: 'domain' | 'path';
    matchValue: string;
}
interface LLMRequestLogFeedback {
    /** Either the raw integer FK or a hashid string (e.g. from a prior response's llm_request_log_id) — the server accepts both on write. */
    llm_request_log_id?: number | string;
    /** @deprecated Use `sentiment` instead */
    like?: boolean;
    sentiment?: "like" | "dislike" | "neutral";
    /** What kind of creator supplied the feedback. Defaults to "unknown" server-side when omitted. */
    creator_type?: "human" | "agent" | "unknown";
    creator_unique_id?: string;
    workload_hashid?: string;
    explanation?: string;
    revised_output?: string;
    llm_provider_unique_id?: string;
    original_output?: string;
    client_unique_id?: string;
    collector?: string;
}
interface LLMRequestLogFeedbackPayload {
    llm_request_log_feedback: LLMRequestLogFeedback;
}
interface McpToolCallResponse {
    result?: unknown;
    error?: {
        message?: string;
        [key: string]: unknown;
    };
}
interface LLMRequestLogFeedbackResponse {
    /** Hashid, not the raw integer FK. */
    id: string;
    /** Hashid, not the raw integer FK — null when this feedback isn't linked to a specific logged request. */
    llm_request_log_id: string | null;
    /** @deprecated Use `sentiment` instead */
    like?: boolean;
    sentiment?: "like" | "dislike" | "neutral";
    /** What kind of creator submitted the feedback: "human", "agent", or "unknown". */
    creator_type?: "human" | "agent" | "unknown";
    creator_unique_id?: string;
    /** Hashid of the workload this feedback is associated with, set server-side from workload_hashid on create.
     *  (There is no separate workload_hashid field on responses — workload_hashid is write-only, on LLMRequestLogFeedback.) */
    workload_id?: string | null;
    explanation?: string;
    revised_output?: string;
    llm_provider_unique_id?: string;
    original_output?: string;
    client_unique_id?: string;
    /** Hashid of the client that owns this feedback entry, matching every other external-facing identifier on this record. */
    client_id?: string;
    collector?: string;
    coolhand_fingerprint_id?: string;
    /** Validation issues encountered while creating this feedback record. */
    warnings?: {
        message: string;
        timestamp: string;
    }[];
    /** Hashid of the `FeedbackPartial` generated when this feedback was created with sectional highlighting. */
    created_partial_id?: string;
    created_at: string;
    updated_at: string;
}
interface SearchFeedbackParams {
    /** Ransack sort expression, e.g. "created_at desc". */
    s?: string;
    /**
     * Sentiment is stored server-side as an integer code — 0=dislike, 1=neutral, 2=like — which
     * responses render back as the `sentiment` string enum. Ransack's `sentiment_eq` predicate
     * takes the raw integer code, not the string label.
     */
    sentiment_eq?: 0 | 1 | 2;
    explanation_cont?: string;
    page?: number;
    per?: number;
    /** Any other Ransack predicate the search endpoint accepts (wrapped as q[<key>]=<value>). */
    [ransackPredicate: string]: string | number | boolean | undefined;
}
interface LLMRequestLogFeedbackSummary {
    /** Hashid identifier for the feedback record (not a raw integer). */
    id: string;
    /** Hashid, not the raw integer FK — null when this feedback isn't linked to a specific logged request. */
    llm_request_log_id: string | null;
    /** @deprecated Use `sentiment` instead */
    like?: boolean;
    sentiment?: "like" | "dislike" | "neutral";
    creator_type?: "human" | "agent" | "unknown";
    creator_unique_id?: string;
    /** Hashid of the associated workload (see {@link LLMRequestLogFeedbackResponse.workload_id}). */
    workload_id?: string | null;
    explanation?: string;
    llm_provider_unique_id?: string;
    client_unique_id?: string;
    /** Hashid of the client that owns this feedback entry, matching every other external-facing identifier on this record. */
    client_id?: string;
    collector?: string;
    coolhand_fingerprint_id?: string;
    created_at: string;
    updated_at: string;
}
interface Pagination {
    current_page: number;
    per_page: number;
    total_count: number;
    total_pages: number;
    has_next_page: boolean;
    has_prev_page: boolean;
}
/** @deprecated Renamed to {@link Pagination} — kept as an alias for existing imports. */
type FeedbackPagination = Pagination;
interface SearchFeedbackResponse {
    feedback: LLMRequestLogFeedbackSummary[];
    pagination: Pagination;
}
interface LLMRequestLogFeedbackFocusRange {
    start: number;
    end: number;
}
interface LLMRequestLogFeedbackPartial {
    id: string;
    llm_request_log_feedback_id: string;
    /** Hashid of the client that owns the parent feedback record (matches {@link LLMRequestLogFeedbackResponse.client_id}). */
    client_id: string;
    focus_section?: string | null;
    focus_range?: LLMRequestLogFeedbackFocusRange | null;
    sentiment?: "like" | "dislike" | "neutral" | null;
    /** @deprecated Use `sentiment` instead */
    like?: boolean | null;
    explanation?: string | null;
    creator_unique_id?: string | null;
    coolhand_fingerprint_id?: string | null;
    created_at: string;
    updated_at: string;
}
interface LLMRequestLogFeedbackDetail extends LLMRequestLogFeedbackResponse {
    feedback_partials?: LLMRequestLogFeedbackPartial[];
}
interface GetLogContentSliceOptions {
    /**
     * Which part of each content field to return (default: `"full"`). Only takes effect together
     * with `maxChars` — without it, the server returns the entire field regardless of `section`
     * (and sets neither `truncated` nor `total_chars`), which is the opposite of what a caller
     * reaching for `"end"`/`"beginning"` on a huge log is usually trying to avoid.
     */
    section?: 'full' | 'beginning' | 'end';
    /** Max characters per content field — slices from the start, or the requested `section`. */
    maxChars?: number;
    searchQuery?: undefined;
    /** Include `thinking_response` in the result (default: false). */
    includeThinking?: boolean;
}
interface GetLogContentSearchOptions {
    section?: undefined;
    maxChars?: undefined;
    /** Text to search for; returns up to 5 matching snippets per field with surrounding context. */
    searchQuery: string;
    /** Include `thinking_response` in the result (default: false). */
    includeThinking?: boolean;
}
type GetLogContentOptions = GetLogContentSliceOptions | GetLogContentSearchOptions;
interface LlmRequestLogContentFields {
    system_prompt: string | null;
    user_prompt: string | null;
    output: string | null;
}
interface LlmRequestLogContentBase {
    /** Hashid. */
    id: string;
    url: string;
    model: string | null;
    source_api: string | null;
    /** Hashid, null when this log isn't matched to a template. */
    template_id: string | null;
    template_name: string | null;
    input_tokens: number | null;
    output_tokens: number | null;
    latency_ms: number | null;
    created_at: string;
    /**
     * Only present when `includeThinking` was set; null when the log has no thinking response.
     * An array of thinking blocks (the backend stores/returns this as `jsonb`, not a single string).
     */
    thinking_response?: string[] | null;
}
interface LlmRequestLogContentFull extends LlmRequestLogContentBase, LlmRequestLogContentFields {
    /** Set when `section`/`maxChars` produced a partial result. */
    truncated?: boolean;
    /** Full length of each field, present alongside `truncated`. */
    total_chars?: Record<keyof LlmRequestLogContentFields, number>;
}
interface LlmRequestLogContentSearchResult extends LlmRequestLogContentBase {
    search_query: string;
    matches: Record<keyof LlmRequestLogContentFields, string[]>;
}
type LlmRequestLogContent = LlmRequestLogContentFull | LlmRequestLogContentSearchResult;
interface SearchLogsParams {
    /** Template hashid. */
    templateId?: string;
    /** Workload hashid — matches all templates in that workload. */
    workloadId?: string;
    /** Case-insensitive substring match against the system prompt. */
    systemPromptContains?: string;
    /** Case-insensitive substring match against the user prompt. */
    userPromptContains?: string;
    model?: string;
    sourceApi?: string;
    sourceApiResult?: string;
    /** Only return logs with no assigned template. */
    unmatchedOnly?: boolean;
    /** Limit to logs created in the last N days. Unrestricted when omitted — there's no implicit default. */
    daysBack?: number;
    /** Include `system_prompt`/`user_prompt` (truncated to 500 chars) on each result. */
    includePrompts?: boolean;
    /** Ransack sort expression, e.g. `"created_at desc"` — sent as `q[s]`. The endpoint defaults to
     *  newest-first (`id desc`) when omitted, so pagination stays deterministic. */
    sort?: string;
    /** Page number. */
    page?: number;
    /** Page size (default 25, max 100 — enforced server-side; `per_page` is also accepted on the wire but this SDK only sends `per`). */
    per?: number;
    /** Ask the backend to compute exact `total_count`/`total_pages` (via `X-Total-Count`/
     *  `X-Total-Pages` response headers) instead of the client-side lower-bound estimate. Costs a
     *  `COUNT(*)` on the backend, so it's opt-in and defaults to off — leave it unset for
     *  high-frequency polling. No effect until Coolhand-Labs/coolhand#1096 ships. */
    includeTotal?: boolean;
}
interface LlmRequestLogSummary {
    /** Hashid. */
    id: string;
    collector: string | null;
    source_api: string | null;
    source_api_result: string | null;
    model: string | null;
    /** Hashid, null when this log isn't matched to a template. */
    template_id: string | null;
    template_name: string | null;
    input_tokens: number | null;
    output_tokens: number | null;
    latency_ms: number | null;
    created_at: string;
    updated_at: string;
    system_prompt?: string | null;
    user_prompt?: string | null;
}
interface SearchLogsResponse {
    logs: LlmRequestLogSummary[];
    pagination: Pagination;
}

export type { CoolhandAPIPattern, CoolhandAPIPatterns, CoolhandCallData, CoolhandClientFilePayload, CoolhandClientFileResponse, CoolhandLogPayload, CoolhandLogResponse, CoolhandMatchedPattern, CoolhandOptions, CoolhandRequestOptions, CoolhandStats, FeedbackPagination, GetLogContentOptions, GetLogContentSearchOptions, GetLogContentSliceOptions, LLMRequestLogFeedback, LLMRequestLogFeedbackDetail, LLMRequestLogFeedbackFocusRange, LLMRequestLogFeedbackPartial, LLMRequestLogFeedbackPayload, LLMRequestLogFeedbackResponse, LLMRequestLogFeedbackSummary, LlmRequestLogContent, LlmRequestLogContentBase, LlmRequestLogContentFields, LlmRequestLogContentFull, LlmRequestLogContentSearchResult, LlmRequestLogSummary, McpToolCallResponse, Pagination, SearchFeedbackParams, SearchFeedbackResponse, SearchLogsParams, SearchLogsResponse };