import type { RoolSpace } from './space.js';
import type { Conversation, Interaction, PromptOptions, RoolObject } from './types.js';
export declare function generateEntityId(): string;
/** Find the most recently updated leaf in a conversation tree. */
export declare function defaultConversationLeaf(conversation: Conversation | null): string | undefined;
/** Return one conversation branch in root-to-leaf order. */
export declare function conversationBranch(conversation: Conversation | null, leafId?: string | undefined): Interaction[];
/** An imperative API scoped to one conversation. It retains no conversation state. */
export declare class ConversationHandle {
    private space;
    readonly conversationId: string;
    constructor(space: RoolSpace, conversationId: string);
    /** Fetch the current conversation contents. */
    get(): Promise<Conversation | null>;
    /** Set the conversation system instruction. Pass null to clear it. */
    setSystemInstruction(instruction: string | null): Promise<void>;
    rename(name: string): Promise<void>;
    delete(): Promise<void>;
    /**
     * Prompt this conversation. With no explicit parent, continue from the
     * current default leaf without retaining a client-side cursor.
     */
    prompt(text: string, options?: PromptOptions): Promise<{
        message: string;
        objects: RoolObject[];
        creditsUsed: number;
    }>;
    stop(): Promise<boolean>;
}
//# sourceMappingURL=space-session.d.ts.map