import React from 'react';
import type { AgentActivityStatus } from './agent-status.js';
export type { AgentActivityStatus } from './agent-status.js';
export interface AgentActivityProps extends React.HTMLAttributes<HTMLOListElement> {
    children?: React.ReactNode;
    /**
     * Announce the step that just became active, once, in a polite live region.
     *
     * On by default because the whole point of an activity log is knowing what
     * the agent is doing without watching it. Turn it off when several logs are
     * on screen at once, or they narrate over each other.
     */
    announceActive?: boolean;
}
export interface AgentActivityStepProps extends React.LiHTMLAttributes<HTMLLIElement> {
    /** What the agent did, in the user's language. Not a function name. */
    children?: React.ReactNode;
    status?: AgentActivityStatus;
    /** The result, a tool name, a count — whatever makes the step checkable. */
    detail?: React.ReactNode;
    /**
     * The status in words, read after the step's label — "Not started", "In
     * progress", "Done", "Failed", "Skipped" in English. Pass the translation
     * for `status`.
     */
    statusLabel?: string;
}
/**
 * AgentActivity — what the agent is doing, in plain language.
 *
 * An ordered list, because the steps happened in an order and a screen reader
 * should say "3 of 7". Not a log viewer: this is the account a person reads to
 * decide whether to let the run continue, so the text belongs in their
 * language — "Searched the invoice archive", not `searchIndex(q, {limit:50})`.
 *
 * STATUS IS NEVER CARRIED BY THE ICON ALONE. Every step renders its status as
 * text as well as a glyph. The glyphs differ in shape rather than only in
 * colour, so the list survives greyscale, colour blindness and forced-colours
 * mode — WCAG 1.4.1, which a row of coloured dots fails outright.
 *
 * ONE POLITE ANNOUNCEMENT PER STEP, not one per render. The active step's text
 * is announced when it changes, so a user who is not watching still knows where
 * the run has got to. Watching the DOM instead would re-announce on every
 * unrelated update, which is the failure mode that makes people turn logs off.
 */
export declare const AgentActivity: React.ForwardRefExoticComponent<AgentActivityProps & React.RefAttributes<HTMLOListElement>>;
export declare const AgentActivityStep: React.ForwardRefExoticComponent<AgentActivityStepProps & React.RefAttributes<HTMLLIElement>>;
//# sourceMappingURL=AgentActivity.d.ts.map