import { Plur } from '@plur-ai/core';

/**
 * Output formatting for CLI.
 * Detects TTY vs piped, formats as human-readable or JSON.
 */
interface OutputOptions {
    json?: boolean;
    quiet?: boolean;
}

interface GlobalFlags extends OutputOptions {
    path?: string;
    fast?: boolean;
}
/** Parse global flags from argv, return remaining positional args + flags. */
declare function parseGlobalFlags(argv: string[]): {
    flags: GlobalFlags;
    args: string[];
};
/**
 * Create Plur instance from flags.
 *
 * `readonly: true` opens a write-guarded engine (#731): reads work, every
 * mutation throws `ReadonlyStoreError`, and recall skips its activation
 * refresh. Read-only commands (`list`, `status`, `tensions` list mode) pass it
 * so lazy engine side-effects cannot mutate the store from a pure query.
 */
declare function createPlur(flags: GlobalFlags, options?: {
    readonly?: boolean;
}): Plur;

export { type GlobalFlags, createPlur, parseGlobalFlags };