/**
 * The `/status` report: what this conversation is pointed at and what its
 * agent is doing, assembled by the bridge from channel state alone — no agent
 * is created to answer it, because "what would my next message do" must be
 * answerable before a first message exists.
 * @module dsh-lark-channel/status
 */
import type { HostSession, HostSessionProjections } from './host.ts';
import type { PresetOption } from './permission.ts';
import type { ConversationSubject } from './session.ts';
/** What one session's meters report, in the shape the status card takes. */
export interface SessionMeters {
    readonly context?: {
        readonly used: number;
        readonly window?: number | undefined;
    } | undefined;
    readonly usage?: {
        readonly input: number;
        readonly output: number;
        readonly cacheRead: number;
        readonly cacheWrite: number;
    } | undefined;
}
/**
 * Read one live session's token meters.
 *
 * Everything here is optional by the host's own contract: a deployment may
 * compose no token meter, and a session that has not made a request yet has no
 * sample. Absent stays absent — a status row claiming zero tokens where the
 * meter simply is not there would be a lie an operator acts on.
 * @param projections - the session projection registry, when composed.
 * @param session - the live session; an unbound conversation has none.
 * @returns the meters worth showing, each present only when known.
 */
export declare function readMeters(projections: HostSessionProjections | undefined, session: HostSession | undefined): SessionMeters;
/** Show this conversation's routing and activity. Channel-owned: needs no agent. */
export declare const STATUS_COMMAND = "status";
/** Marks this plugin's status refresh apart from other card actions. */
export declare const STATUS_ACTION = "dsh-lark-channel/status";
/** Card payload carried by a status refresh. */
export interface StatusActionValue extends ConversationSubject {
    readonly kind: typeof STATUS_ACTION;
}
/**
 * Narrow an arbitrary card-action value to this module's refresh payload.
 * @param value - raw button value from a card action event.
 * @returns the typed payload, or undefined for foreign card actions.
 */
export declare function statusActionValue(value: unknown): StatusActionValue | undefined;
/** Everything the report states, resolved by the bridge. */
export interface StatusFields {
    /** The directory the conversation's agent runs in. */
    readonly workspace: string;
    /** Whether that is the deployment default. */
    readonly workspaceIsDefault: boolean;
    /** Display form of the model route. */
    readonly route: string;
    /** Whether that is the deployment default. */
    readonly routeIsDefault: boolean;
    /** The durable session id the conversation resolves to. */
    readonly sessionId: string;
    /** Whether an agent is currently bound for the conversation. */
    readonly bound: boolean;
    /** Whether this conversation has an explicit /session switch (resumed on next message). */
    readonly switched?: boolean | undefined;
    /** Whether a turn is running right now. */
    readonly running: boolean;
    /** Open approval cards waiting in this chat. */
    readonly pendingApprovals: number;
    /** The running plugin's version; empty hides the row rather than lying. */
    readonly version: string;
    /**
     * The permission preset in force, as the deployment defines it — the knobs
     * travel with the name so the row describes what the session can actually
     * do rather than what its preset happens to be called.
     */
    readonly preset?: PresetOption | undefined;
    /**
     * What the next request would carry against what the model can hold. Absent
     * until a session has made one request, and absent entirely where the
     * deployment composed no token meter.
     */
    readonly context?: {
        readonly used: number;
        readonly window?: number | undefined;
    } | undefined;
    /** Whole-session token totals, when the meter is composed. */
    readonly usage?: {
        readonly input: number;
        readonly output: number;
        readonly cacheRead: number;
        readonly cacheWrite: number;
    } | undefined;
}
/**
 * Render the report as a card.
 *
 * The refresh button carries the conversation rather than reading it from the
 * click, because the facets a key is built from — a thread, a sender — are not
 * in a card action at all. It is the same reason every control card here
 * carries its own subject.
 * @param fields - resolved status facts.
 * @param subject - the conversation the report is about, and where it lives.
 * @returns a card object for `send({ card })`.
 */
export declare function renderStatusCard(fields: StatusFields, subject: ConversationSubject): object;
//# sourceMappingURL=status.d.ts.map