/**
 * TencentDB Agent Memory v2 TypeScript SDK — `MemoryClient`.
 *
 * 14 methods mapping 1:1 to the v2 data-plane API.
 */
import type { AtomicUpdateData, AtomicUpdateRequest, AtomicCountRequest, AtomicDeleteData, AtomicDeleteRequest, AtomicQueryData, AtomicQueryRequest, AtomicSearchData, AtomicSearchRequest, ConversationAddData, ConversationAddRequest, ConversationCountRequest, ConversationDeleteData, ConversationDeleteRequest, ConversationQueryData, ConversationQueryRequest, ConversationSearchData, ConversationSearchRequest, CoreCountRequest, CoreFile, CoreReadRequest, CoreWriteData, CoreWriteRequest, CountData, OffloadCompactData, OffloadCompactRequest, OffloadIngestData, OffloadIngestRequest, OffloadQueryMmdData, OffloadQueryMmdRequest, ScenarioCountRequest, ScenarioFile, ScenarioListData, ScenarioListRequest, ScenarioReadRequest, ScenarioRmRequest, ScenarioWriteData, ScenarioWriteRequest } from "./types.js";
export interface MemoryClientConfig {
    /** Base URL, e.g. `https://memory.tencentyun.com` */
    endpoint: string;
    /** Bearer token */
    apiKey: string;
    /** Memory instance ID (sent via `x-tdai-service-id` header). */
    serviceId: string;
    /** Request timeout in ms (default 30 000). */
    timeout?: number;
    /** Whether to reject invalid TLS certificates. Default: false (self-signed friendly). */
    rejectUnauthorized?: boolean;
}
/**
 * Transport interface for testing — inject a mock that satisfies this.
 */
export interface Transport {
    post<T>(path: string, body?: Record<string, unknown>): Promise<T>;
}
export declare class MemoryClient {
    private readonly http;
    private readonly config;
    constructor(config: MemoryClientConfig);
    constructor(transport: Transport);
    addConversation(params: ConversationAddRequest): Promise<ConversationAddData>;
    queryConversation(params?: ConversationQueryRequest): Promise<ConversationQueryData>;
    searchConversation(params: ConversationSearchRequest): Promise<ConversationSearchData>;
    deleteConversation(params: ConversationDeleteRequest): Promise<ConversationDeleteData>;
    countConversation(params?: ConversationCountRequest): Promise<CountData>;
    updateAtomic(params: AtomicUpdateRequest): Promise<AtomicUpdateData>;
    queryAtomic(params?: AtomicQueryRequest): Promise<AtomicQueryData>;
    searchAtomic(params: AtomicSearchRequest): Promise<AtomicSearchData>;
    deleteAtomic(params: AtomicDeleteRequest): Promise<AtomicDeleteData>;
    countAtomic(params?: AtomicCountRequest): Promise<CountData>;
    listScenarios(params?: ScenarioListRequest): Promise<ScenarioListData>;
    readScenario(params: ScenarioReadRequest): Promise<ScenarioFile>;
    writeScenario(params: ScenarioWriteRequest): Promise<ScenarioWriteData>;
    rmScenario(params: ScenarioRmRequest): Promise<void>;
    countScenario(params?: ScenarioCountRequest): Promise<CountData>;
    readCore(params?: CoreReadRequest): Promise<CoreFile>;
    writeCore(params: CoreWriteRequest): Promise<CoreWriteData>;
    countCore(params?: CoreCountRequest): Promise<CountData>;
    /**
     * Send tool pairs (+ optional context) to offload server for L1 processing.
     * Fire-and-forget usage: caller can `.catch()` without blocking.
     */
    offloadIngest(params: OffloadIngestRequest): Promise<OffloadIngestData>;
    /**
     * Request server-side context compaction.
     * Returns compacted messages + report, or throws on failure.
     */
    offloadCompact(params: OffloadCompactRequest): Promise<OffloadCompactData>;
    /**
     * Query MMD task graphs for a session.
     * limit=1 returns only the current active MMD (fast path).
     */
    offloadQueryMmd(params: OffloadQueryMmdRequest): Promise<OffloadQueryMmdData>;
    /**
     * Read a memory pipeline artifact (e.g. `persona.md`, `scene_blocks/*.md`)
     * by relative path.
     *
     * @param path Relative path within the memory space, e.g.
     *   `"scene_blocks/cooking-recipes.md"` or `"persona.md"`.
     * @returns File content as string.
     */
    readFile(path: string): Promise<string>;
    private fileReader;
}