import type { ImageContent, Message, TextContent, Usage } from "@bastani/pi-ai/compat";
import type { VerbatimCompactionDetails } from "./compaction/compaction-types.js";
import type { BashExecutionMessage, CustomMessage } from "./messages.ts";
import type { ContextEditEntry, FileEntry, NewSessionOptions, SessionContext, SessionEntry, SessionHeader, SessionInfo, SessionListProgress, SessionNameState, SessionProjection, SessionTreeNode, SessionWorkflowMetadata, UsageEntry } from "./session-manager-types.ts";
import { type SessionJsonValue } from "./storage/session/errors.js";
import type { SessionStore } from "./storage/session/types.js";
/** An in-memory session tree whose mutations await the backing store. */
export declare class SessionManager {
    private sessionId;
    private sessionFile;
    private sessionDir;
    private cwd;
    private store;
    private lastSeq;
    private mutation;
    private fileEntries;
    private byId;
    private labelsById;
    private labelTimestampsById;
    private leafId;
    private constructor();
    private runMutation;
    private recordHeader;
    private restore;
    private start;
    setSessionFile(sessionFile: string): Promise<void>;
    private initialize;
    private storeForNewSession;
    newSession(options?: NewSessionOptions): Promise<string | undefined>;
    markSessionInternal(workflow?: SessionWorkflowMetadata): Promise<void>;
    private _buildIndex;
    isPersisted(): boolean;
    getCwd(): string;
    getSessionDir(): string;
    usesDefaultSessionDir(): boolean;
    getSessionId(): string;
    getSessionFile(): string | undefined;
    getSessionStore(): SessionStore;
    deleteSession(sessionId: string): Promise<void>;
    /** @internal Finalize provisional startup storage after project trust resolves. */
    rebindStore(store: SessionStore, removeProvisionalRecord: boolean): Promise<void>;
    openSessionById(sessionId: string, cwdOverride?: string, sessionDirectory?: string): Promise<SessionManager>;
    importFromJsonl(inputPath: string, cwdOverride?: string): Promise<SessionManager>;
    private _appendEntry;
    /** Append a message as child of current leaf, then advance leaf. Returns entry id. */
    appendMessage(message: Message | CustomMessage | BashExecutionMessage): Promise<string>;
    /** Append a thinking level change as child of current leaf, then advance leaf. Returns entry id. */
    appendThinkingLevelChange(thinkingLevel: string): Promise<string>;
    /** Record auxiliary model usage without adding it to the LLM context. */
    appendUsage(kind: string, provider: string, model: string, usage: Usage, note?: string): Promise<UsageEntry>;
    /** Append a model change as child of current leaf, then advance leaf. Returns entry id. */
    appendModelChange(provider: string, modelId: string): Promise<string>;
    appendCompaction(compactedText: string, firstKeptEntryId: string | null, tokensBefore: number, details: VerbatimCompactionDetails, usage?: Usage): Promise<string>;
    /** Save a JSONL backup; database-backed sessions have no file snapshot. */
    writeBackupSnapshot(label?: string): Promise<string | undefined>;
    /** Append a branch-local edit to an earlier model-visible entry. */
    appendContextEdit(targetId: string, replacement: ContextEditEntry["replacement"]): Promise<string>;
    /** Append a custom entry (for extensions) as child of current leaf, then advance leaf. Returns entry id. */
    appendCustomEntry<T = SessionJsonValue>(customType: string, data?: T): Promise<string>;
    /** Append a session info entry (e.g., display name). Returns entry id. */
    appendSessionInfo(name: string): Promise<string>;
    /** Append a generated resume summary anchored to the message it describes. Returns entry id. */
    appendSessionSummary(summary: string, summarizedThroughId: string, usage?: Usage): Promise<string>;
    /** Get the current session name from the latest session_info entry, if any. */
    getSessionName(): string | undefined;
    /**
     * Get the session name state. `hasName` is true for a session that was named and
     * then cleared even though `name` is undefined; a never-named session reports
     * `hasName: false`. Read-side only: the JSONL already records the distinction.
     */
    getSessionNameState(): SessionNameState;
    /** Append a custom message entry (for extensions) that participates in LLM context unless excluded. */
    appendCustomMessageEntry<T = SessionJsonValue>(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details?: T, excludeFromContext?: boolean, protectedReconciliation?: {
        delivery: "steer" | "followUp";
    }, stageAdmissionKey?: string): Promise<string>;
    getLeafId(): string | null;
    getLeafEntry(): SessionEntry | undefined;
    getEntry(id: string): SessionEntry | undefined;
    /** Get all direct children of an entry. */
    getChildren(parentId: string): SessionEntry[];
    /** Get the label for an entry, if any. */
    getLabel(id: string): string | undefined;
    /** Set or clear a label on an entry. */
    appendLabelChange(targetId: string, label: string | undefined): Promise<string>;
    /** Walk from entry to root, returning all entries in path order. */
    getBranch(fromId?: string): SessionEntry[];
    /** Return the active branch entries after applying the latest compaction boundary. */
    buildContextEntries(): SessionEntry[];
    /** Build provenance-preserving, compaction-aware model context from the current leaf. */
    buildSessionProjection(): SessionProjection;
    /** Build the session context (what gets sent to the LLM). */
    buildSessionContext(): SessionContext;
    /** Get session header. */
    getHeader(): SessionHeader | null;
    /** Number of entries without copying the session history. */
    getEntryCount(): number;
    /** Get all session entries (excludes header). Returns a shallow copy. */
    getEntries(): SessionEntry[];
    /** Get the session as a tree structure. Returns a shallow defensive copy of all entries. */
    getTree(): SessionTreeNode[];
    /** Start a new branch from an earlier entry. */
    branch(branchFromId: string): Promise<void>;
    /** Reset the leaf pointer to null (before any entries). */
    resetLeaf(): Promise<void>;
    /** Start a new branch with a summary of the abandoned path. */
    branchWithSummary<T = SessionJsonValue>(branchFromId: string | null, summary: string, details?: T, fromHook?: boolean, usage?: import("@bastani/pi-ai/compat").Usage, fromId?: string): Promise<string>;
    createBranchedSession(leafId: string): Promise<string | undefined>;
    forkTo(cwd: string, sessionDir?: string | SessionStore, options?: NewSessionOptions): Promise<SessionManager>;
    static importFromJsonl(inputPath: string, cwd: string, sessionDir?: string | SessionStore): Promise<SessionManager>;
    private static constructWithStore;
    static create(cwd: string, sessionDir?: string, options?: NewSessionOptions): Promise<SessionManager>;
    static create(store: SessionStore, cwd: string, options?: NewSessionOptions): Promise<SessionManager>;
    static open(path: string, sessionDir?: string, cwdOverride?: string): Promise<SessionManager>;
    static open(store: SessionStore, sessionId: string, cwdOverride?: string): Promise<SessionManager>;
    static continueRecent(cwd: string, sessionDir?: string, options?: {
        includeInternal?: boolean;
    }): Promise<SessionManager>;
    static continueRecent(store: SessionStore, cwd: string, options?: {
        includeInternal?: boolean;
    }): Promise<SessionManager>;
    static inMemory(cwd?: string, options?: NewSessionOptions, entries?: FileEntry[]): SessionManager;
    static forkFrom(sourcePath: string, targetCwd: string, sessionDir?: string, options?: NewSessionOptions): Promise<SessionManager>;
    static findById(cwd: string, id: string, sessionDir?: string): Promise<string | undefined>;
    static list(cwd: string, sessionDir?: string | SessionStore, onProgress?: SessionListProgress, options?: {
        includeInternal?: boolean;
        signal?: AbortSignal;
    } | AbortSignal): Promise<SessionInfo[]>;
    static listAll(onProgress?: SessionListProgress, signal?: AbortSignal): Promise<SessionInfo[]>;
    static listAll(sessionDir?: string | SessionStore, onProgress?: SessionListProgress, options?: {
        includeInternal?: boolean;
        signal?: AbortSignal;
    } | AbortSignal): Promise<SessionInfo[]>;
}
//# sourceMappingURL=session-manager-core.d.ts.map