/**
 * Common Types
 *
 * Shared types used across multiple modules: Result, Cache, Embeddings, CLI.
 */
export type ApiErrorType = 'rate_limit' | 'auth' | 'quota' | 'network' | 'invalid_response' | 'invalid_request';
export interface ApiError {
    readonly type: ApiErrorType;
    readonly message: string;
    readonly retryAfter?: number | undefined;
}
export type Result<T> = {
    readonly ok: true;
    readonly value: T;
} | {
    readonly ok: false;
    readonly error: ApiError;
};
interface EmbeddingProgressInfo {
    readonly phase: 'messages' | 'queries';
    readonly batchIndex: number;
    readonly totalBatches: number;
    readonly itemsInBatch: number;
    readonly totalItems: number;
    readonly cacheHit: boolean;
}
export interface EmbeddingConfig {
    readonly apiKey: string;
    readonly model?: string;
    readonly batchSize?: number;
    readonly concurrency?: number;
    readonly onBatchStart?: (info: EmbeddingProgressInfo) => void;
    readonly onBatchComplete?: (info: EmbeddingProgressInfo & {
        durationMs: number;
    }) => void;
}
export interface EmbeddedMessage {
    readonly messageId: number;
    readonly content: string;
    readonly embedding: Float32Array;
}
export interface SemanticSearchConfig {
    readonly queries?: readonly string[];
    readonly topK?: number;
    readonly minSimilarity?: number;
}
export interface CLIOptions {
    readonly outputDir?: string | undefined;
    readonly format?: readonly string[] | undefined;
    readonly region?: string | undefined;
    readonly parallel?: number | undefined;
    readonly minConfidence?: number | undefined;
    readonly skipEmbeddings?: boolean | undefined;
    readonly skipPlaceLookup?: boolean | undefined;
    readonly quiet?: boolean | undefined;
    readonly verbose?: boolean | undefined;
    readonly dryRun?: boolean | undefined;
    readonly openaiKey?: string | undefined;
    readonly anthropicKey?: string | undefined;
    readonly openrouterKey?: string | undefined;
    readonly googleMapsKey?: string | undefined;
}
export interface ProcessingStats {
    readonly messageCount: number;
    readonly candidateCount: number;
    readonly semanticCandidateCount: number;
    readonly activityCount: number;
    readonly errandCount: number;
    readonly geocodedCount: number;
    readonly costs: {
        readonly embeddings: number;
        readonly classification: number;
        readonly geocoding: number;
        readonly total: number;
    };
}
/** Token usage from LLM API calls */
export interface LlmUsage {
    readonly inputTokens: number;
    readonly outputTokens: number;
}
/** Empty LLM usage for cache hits or no-op calls */
export declare const EMPTY_LLM_USAGE: LlmUsage;
/** Add two LLM usage objects together */
export declare function addLlmUsage(a: LlmUsage, b: LlmUsage): LlmUsage;
/** API call counts from place lookup */
export interface PlaceLookupUsage {
    /** Number of Places API Text Search calls */
    readonly placesSearchCalls: number;
    /** Number of Geocoding API calls */
    readonly geocodingCalls: number;
}
/** Empty place lookup usage for cache hits */
export declare const EMPTY_PLACE_LOOKUP_USAGE: PlaceLookupUsage;
/** Add two place lookup usage objects together */
export declare function addPlaceLookupUsage(a: PlaceLookupUsage, b: PlaceLookupUsage): PlaceLookupUsage;
/** Result with usage data for metered API calls */
export interface ResultWithUsage<T, U> {
    readonly result: Result<T>;
    readonly usage: U;
}
export {};
//# sourceMappingURL=common.d.ts.map