import type { HumanMessage } from '@langchain/core/messages';
import { Context, Service } from 'koishi';
import type { LivingMemoryPresetExport, LivingMemoryPresetImportResult, LivingMemorySearchDetailedResult, LivingMemorySearchInput, LivingMemoryTranscriptMessage, MemoryMutationInput, MemoryScope, MemoryUpdatePatch, PresetPersonaCardInfo } from '../../contracts/memory';
import type { JobListQuery, MemoryListFilter, MemoryListQuery, SnapshotListQuery, UserProfileListQuery } from '../../contracts/rpc';
import type { AttributedMemoryItem, DreamTriggerResult, LivingMemoryConfig, MemoryConfigWarning, MemoryServiceStatus } from '../../contracts/workflows';
import type { QueueExtractionOptions } from '../memory/helpers';
import { type CreateLivingMemoryScopeOptions } from './scope';
import { type LivingMemoryPromptSectionsOptions } from './prompt_hydration';
import { LivingMemoryLogger } from '../logging/logger';
import { MessageLogRegistry } from '../transcript/message_log/message_log_registry';
export declare class ChatLunaLivingMemoryService extends Service<LivingMemoryConfig> {
    readonly ctx: Context;
    config: LivingMemoryConfig;
    readonly memoryLogger: LivingMemoryLogger;
    /** 会话消息日志：召回与提取共用的唯一消息历史视界。 */
    readonly messageLog: MessageLogRegistry;
    private readonly repository;
    private readonly recallCoordinator;
    private readonly extractionCoordinator;
    private readonly dreamCoordinator;
    private readonly presetCatalog;
    private readonly userProfiles;
    private readonly presetPersona;
    private readonly searchEngine;
    private readonly vectorIndex;
    private readonly dreamWorker;
    private readonly mutations;
    private archivedMemoryCleanup;
    constructor(ctx: Context, config: LivingMemoryConfig);
    private createRecallCoordinator;
    private createDreamCoordinator;
    private createExtractionCoordinator;
    /** 每日维护：清理过期任务，并调度过期归档记忆的衰减清理。 */
    private scheduleDailyMaintenance;
    protected start(): Promise<void>;
    protected stop(): Promise<void>;
    validateConfig(): MemoryConfigWarning[];
    getStatus(): MemoryServiceStatus;
    resolvePresetId(message: HumanMessage, fallbackPresetId?: string): string | null;
    createScope(conversationId: string, presetId: string, userId?: string, channelId?: string, options?: CreateLivingMemoryScopeOptions): MemoryScope;
    recordPresetSpeaker(scope: Pick<MemoryScope, 'presetId' | 'speakerId' | 'userId' | 'platform'>, speakerLabel: string): Promise<void>;
    hydratePromptSections(scope: Pick<MemoryScope, 'presetId' | 'conversationId'>, options?: LivingMemoryPromptSectionsOptions): Promise<{
        snapshot: string;
        userProfiles: string;
    }>;
    queueRecall(scope: MemoryScope, currentMessage: LivingMemoryTranscriptMessage, loadHistoryMessages: () => Promise<LivingMemoryTranscriptMessage[]>): Promise<void>;
    queueExtraction(scope: MemoryScope, options: QueueExtractionOptions, initialCursor?: () => number): Promise<void>;
    clearExtractionState(): void;
    clearRecallState(): void;
    cleanupConversation(conversationId: string): Promise<void>;
    listPresetIds(): Promise<string[]>;
    /**
     * 读取预设人设卡片正文，供外部插件使用：已落库时返回卡片，否则返回预设
     * system 部分原文。只读，不调模型、不落库。
     */
    resolvePresetPersona(presetId: string): Promise<string>;
    /**
     * 读取单个预设人设卡片（只读视图，不含模型调用）。外部插件需要卡片正文时
     * 用 `resolvePresetPersona`，需要异常提示或落库时间时用这里。
     */
    getPresetPersonaCard(presetId: string): Promise<PresetPersonaCardInfo | undefined>;
    /** 列出全部预设人设卡片及其异常提示，供 Console 展示与外部插件读取。 */
    listPresetPersonas(): Promise<PresetPersonaCardInfo[]>;
    /** 保存手工编辑的预设人设卡片；此后不再被自动覆盖。 */
    savePresetPersonaCard(presetId: string, card: string): Promise<void>;
    /** 丢弃手工卡片并按当前预设原文重新生成。 */
    resetPresetPersonaCard(presetId: string): Promise<void>;
    listMemories(query: MemoryListQuery): Promise<import("../..").MemoryListResult>;
    listMemoryIds(filter: MemoryListFilter): Promise<string[]>;
    findActiveMemoryIdsByText(presetId: string, text: string): Promise<string[]>;
    findActiveMemoryIdsByUser(presetId: string, platform: string, userId: string): Promise<string[]>;
    findUserProfileIdByUser(presetId: string, platform: string, userId: string): Promise<string>;
    archiveActiveMemories(presetId: string, ids: string[]): Promise<{
        archived: number;
    }>;
    getMemory(memoryId: string): Promise<import("../..").MemoryEntryRecord | undefined>;
    searchMemoriesDetailed(presetId: string, input: LivingMemorySearchInput): Promise<LivingMemorySearchDetailedResult[]>;
    searchMemories(presetId: string, input: LivingMemorySearchInput, conversationId?: string): Promise<import("../..").LivingMemorySearchResult[]>;
    getMemorySourceMessages(presetId: string, memoryId: string): Promise<import("../..").LivingMemoryGetMessagesMemory | null>;
    createMemory(scope: MemoryScope, input: MemoryMutationInput, speakerKeys?: string[]): Promise<import("../..").MemoryEntryRecord>;
    updateMemory(memoryId: string, patch: MemoryUpdatePatch): Promise<void>;
    updateActiveMemory(presetId: string, memoryId: string, patch: Omit<MemoryUpdatePatch, 'status'>): Promise<import("../..").MemoryEntryRecord | null>;
    splitActiveMemory(presetId: string, sourceMemoryId: string, memories: AttributedMemoryItem[]): Promise<{
        memories: import("../..").MemoryEntryRecord[];
        warnings: string[];
    }>;
    mergeActiveMemories(presetId: string, sourceMemoryIds: string[], memory: AttributedMemoryItem): Promise<{
        memory: import("../..").MemoryEntryRecord;
        warnings: string[];
    }>;
    deleteMemory(memoryId: string): Promise<void>;
    deleteMemories(presetId: string, ids: string[]): Promise<{
        deleted: number;
    }>;
    deleteSnapshot(snapshotId: string): Promise<void>;
    listSnapshots(query: SnapshotListQuery): Promise<import("../..").PageResult<import("../..").MemorySnapshotRecord>>;
    listJobs(query: JobListQuery): Promise<import("../..").PageResult<import("../..").MemoryJobRecord>>;
    listUserProfiles(query: UserProfileListQuery): Promise<import("../..").PageResult<import("../..").UserProfileRecord>>;
    listPresetSpeakers(presetId: string): Promise<import("../..").PresetSpeakerRecord[]>;
    deleteUserProfile(profileId: string): Promise<void>;
    updateUserProfile(profileId: string, content: string): Promise<void>;
    regenerateUserProfile(presetId: string, speakerKey: string): Promise<import("../user_profile").UserProfileGenerationResult>;
    runDream(presetId: string): Promise<DreamTriggerResult>;
    reconcileVectorIndex(presetId: string): Promise<import("../..").MemoryJobRecord>;
    rebuildVectorIndex(): void;
    restartVectorIndex(): Promise<void>;
    clearPresetData(presetId: string): Promise<void>;
    exportPreset(presetId: string): Promise<LivingMemoryPresetExport>;
    importPreset(targetPresetId: string, data: LivingMemoryPresetExport): Promise<LivingMemoryPresetImportResult>;
    cleanupStaleJobs(maxAge?: number): Promise<void>;
    private queueExpiredArchivedMemoryCleanup;
    private cleanupExpiredArchivedMemories;
}