/**
 * One-time "star us on GitHub" nudge.
 *
 * Printed a single time, ever, after a user's first *successful* headline run
 * (`agents run` / `agents teams`). Modelled on the existing warn-once sentinel
 * pattern (see maybeWarnMultiInstall in src/index.ts): a marker under the
 * regenerable runtime-state dir records that the hint was shown so it never
 * repeats. It is a plain inline line — not a toast, not a nag — and stays out
 * of the way of non-interactive, CI, quiet, and JSON output.
 */
/** Canonical GitHub repo the nudge points at (renamed from agents-cli). */
export declare const REPO_URL = "https://github.com/phnx-labs/agi-cli";
/** Has the star nudge already been shown on this machine? */
export declare function hasShownStarNudge(): boolean;
/** Inputs to the pure show/skip decision (kept side-effect free for testing). */
export interface StarNudgeContext {
    /** Caller asked for quiet / JSON output. */
    quiet?: boolean;
    /** stdout is attached to an interactive terminal. */
    isTTY: boolean;
    /** CI is set in the environment. */
    ci: boolean;
    /** User opted out via AGENTS_NO_NUDGE=1. */
    optedOut: boolean;
    /** The one-time sentinel already exists. */
    alreadyShown: boolean;
}
/**
 * Pure decision: should the one-time star nudge be shown? Skipped for
 * quiet/JSON output, non-interactive terminals (pipes, redirects), CI, an
 * explicit opt-out, or once it has already been shown.
 */
export declare function shouldShowStarNudge(ctx: StarNudgeContext): boolean;
/**
 * Show the one-time star nudge if it hasn't been shown yet and the context is
 * appropriate. Best-effort by contract: never throws, never blocks the run it
 * follows.
 *
 * Skipped when: the caller asked for quiet/JSON output, stdout is not an
 * interactive terminal (pipes, redirects), CI is set, or the user opted out
 * with AGENTS_NO_NUDGE=1.
 */
export declare function maybeShowStarNudge(opts?: {
    quiet?: boolean;
}): void;
