/**
 * Filesystem Service Types
 */
export interface FileInfo {
    name: string;
    path: string;
    isDirectory: boolean;
    size: number;
    modified: number;
    extension: string;
}
export interface FileInfoResponse {
    id: string;
    name: string;
    path: string;
    isDirectory: boolean;
    size: string;
    sizeBytes: number;
    modified: number;
    extension: string;
    fileType: FileType;
}
export type FileType = 'folder' | 'notebook' | 'code' | 'data' | 'image' | 'document' | 'file';
export interface DirectoryListing {
    path: string;
    parent: string | null;
    mtime: number;
    items: FileInfoResponse[];
}
export interface MtimeResponse {
    path: string;
    mtime: number;
}
export interface ReadFileResponse {
    path: string;
    type: 'notebook' | 'text' | 'binary';
    content: unknown;
    message?: string;
}
export interface WriteFileOptions {
    path: string;
    content: unknown;
    fileType?: 'text' | 'notebook';
}
export type JsonValue = string | number | boolean | null | JsonValue[] | {
    [key: string]: JsonValue;
};
export type OutputType = 'stdout' | 'stderr' | 'image' | 'html' | 'error' | 'display_data';
export type MimeBundle = Record<string, JsonValue>;
export interface CellOutput {
    id?: string;
    type: OutputType;
    content: string;
    timestamp?: number;
    mimeBundle?: MimeBundle;
    metadata?: Record<string, JsonValue>;
    preferredMimeType?: string;
}
export interface ApiCellOutput {
    type: OutputType;
    content: string;
    mimeBundle?: MimeBundle;
    metadata?: Record<string, JsonValue>;
    preferredMimeType?: string;
}
export interface NebulaCell {
    id: string;
    type: 'code' | 'markdown';
    content: string;
    outputs: CellOutput[];
    isExecuting: boolean;
    pendingOutputReset?: boolean;
    executionCount: number | null;
    scrolled?: boolean;
    scrolledHeight?: number;
    sourceCollapsed?: boolean;
    sourceHeight?: number;
    _metadata?: Record<string, unknown>;
}
export interface NotebookCellsResponse {
    cells: NebulaCell[];
    metadata: JupyterNotebook['metadata'];
    kernelspec: string;
    kernelspecSource?: 'metadata' | 'default' | 'env-default';
    mtime: number;
}
export interface SaveNotebookResult {
    success: boolean;
    mtime: number;
    /** Client sent outputs-unchanged sentinels the server couldn't resolve — it must retry with a full payload. */
    needsFull?: boolean;
}
/**
 * Sentinel the client puts in place of a code cell's outputs when they are
 * unchanged since its last successful save. The server re-uses the outputs
 * already in the file (matched by canonical Jupyter cell ID), so autosaves
 * don't re-upload megabytes of unchanged base64 images over slow uplinks.
 */
export declare const OUTPUTS_UNCHANGED_SENTINEL = "__nebula-outputs-unchanged-v1__";
export interface JupyterCellMetadata {
    nebula_id?: string;
    scrolled?: boolean;
    scrolled_height?: number;
    [key: string]: unknown;
}
export interface JupyterCell {
    /** Stable nbformat 4.5 cell identifier. Older notebooks may omit it. */
    id?: string;
    cell_type: 'code' | 'markdown' | 'raw';
    source: string | string[];
    metadata: JupyterCellMetadata;
    outputs?: JupyterOutput[];
    execution_count?: number | null;
}
export interface JupyterOutput {
    output_type: 'stream' | 'execute_result' | 'display_data' | 'error';
    name?: string;
    text?: string | string[];
    data?: Record<string, unknown>;
    metadata?: Record<string, unknown>;
    ename?: string;
    evalue?: string;
    traceback?: string[];
}
export interface JupyterNotebook {
    cells: JupyterCell[];
    metadata: {
        kernelspec?: {
            display_name: string;
            language: string;
            name: string;
        };
        language_info?: Record<string, unknown>;
        nebula?: {
            agent_created?: boolean;
            agent_permitted?: boolean;
        };
        [key: string]: unknown;
    };
    nbformat: number;
    nbformat_minor: number;
}
export interface NebulaConfig {
    rootDirectory?: string;
}