import type { Token } from "../core/Tokenizer";
import type { LLMResponse } from '../llms/types';
export interface Entity {
    type: string;
    value: string;
    start: number;
    end: number;
}
export interface MetaContext {
    requestId?: string;
    timestamp?: number;
    source?: "http" | "cli" | "worker";
    trace?: Record<string, string>;
}
export interface MemoryContext {
    shortTerm?: unknown;
    longTerm?: unknown;
    cache?: Record<string, unknown>;
}
export interface LLMContext {
    model?: string;
    temperature?: number;
    safety?: {
        allowTools: boolean;
        redactions?: string[];
    };
}
export interface QirrelContext {
    meta?: MetaContext;
    memory?: MemoryContext;
    llm?: LLMContext;
    data?: {
        text: string;
        tokens: Token[];
        entities: Entity[];
        llmResponse?: LLMResponse;
    };
}
/**
 * Factory function to create a QirrelContext with default values
 * @param data - The text processing data to include in the context
 * @param model - Optional LLM model identifier (defaults to 'gemini-2.5-flash')
 * @returns A QirrelContext with sensible defaults
 */
export declare function createQirrelContext(data?: QirrelContext['data'], model?: string): QirrelContext;