/**
 * Tail — follow a live session as it grows.
 *
 * `prose tail [id]` resolves like `session` (any unique id prefix); with no
 * id it picks the most recently modified session for the given cwd (default:
 * the current directory), which is the "watch the agent working over there"
 * move — point it at a worktree and observe the session from outside.
 *
 * Renders the same verbatim format as `session`/`snap`: an initial backlog
 * (last N messages), then each new message as it lands. Pure read, no LLM.
 * Polls by mtime/size; reparses the file on change (the offset-parser is the
 * upgrade path for claude-code journals if polling ever gets heavy).
 */
export interface TailOptions {
    /** Initial backlog: print the last N messages before following (default 10). */
    turns?: number;
    /** Poll interval in milliseconds (default 2000). */
    intervalMs?: number;
    /**
     * Per-message byte cap (default 4096 — tailing is a glance surface; pass 0
     * for the full firehose).
     */
    maxMessageBytes?: number;
    /** Cwd filter for the no-id newest-session pick (default process.cwd()). */
    cwd?: string;
    /** With no id, pick the globally newest session instead of cwd-filtered. */
    any?: boolean;
    /** Stream target (default process.stdout). */
    write?: (chunk: string) => void;
    /** Status/meta target (default process.stderr). */
    writeMeta?: (chunk: string) => void;
}
export declare class NoSessionForCwdError extends Error {
    readonly cwd: string;
    constructor(cwd: string);
}
/**
 * Follow one session until the process is interrupted (or `signal` aborts —
 * tests use that; the CLI just lets Ctrl-C end the process).
 */
export declare function tail(idPrefix: string | undefined, opts?: TailOptions, signal?: AbortSignal): Promise<void>;
//# sourceMappingURL=tail.d.ts.map