/**
 * stacked mode picture.
 *
 * The autonomy model has two layers that used to be read by nothing in
 * common:
 *
 *   - MODE  — `SkillPresenceMode` on the presence lease: the autonomy
 *     level (`full-auto | assisted | strict | 24h`).
 *   - STATE — `.peaks/_runtime/<sid>/24h-state.json`, the 6-state
 *     machine (`IDLE / BRAINSTORM / USER_CONFIRM / 24H_ACTIVE /
 *     WAITING_USER / HANDOFF`): the long-run PHASE *inside* the `24h`
 *     mode.
 *
 * This module is the single place that reads both, plus the Job-mode
 * decision and the resolved auto-compact profile, so `peaks code mode
 * status` (and any future consumer) does not re-derive the stack.
 *
 * Read-only + fail-soft: every sub-read is wrapped so a missing or
 * malformed artifact degrades to `null` / `false` rather than throwing.
 */
import { type SkillPresenceMode } from '../skills/skill-presence-service.js';
import type { State24hSnapshot } from '../24h-mode/state.js';
import { type AutoCompactProfile } from '../code/auto-compact-modes.js';
import { type AutoCompactProfileSource } from '../code/auto-compact-profile.js';
export interface ResolvedPresenceMode {
    readonly mode: SkillPresenceMode | null;
    readonly skill: string | null;
    readonly source: 'canonical' | 'file' | 'env' | 'none';
}
export interface ModeStatus {
    /** Autonomy level from the presence lease; `null` when no lease / no mode recorded. */
    readonly mode: SkillPresenceMode | null;
    /** Active skill name from the same lease read (display aid). */
    readonly skill: string | null;
    /** Where the mode came from. */
    readonly modeSource: 'canonical' | 'file' | 'env' | 'none';
    /** `true` when the resolved mode is `24h`. */
    readonly is24h: boolean;
    /**
     * The 24h internal state machine snapshot. Populated only when
     * `is24h` is true (the phase is meaningless outside the 24h mode);
     * `null` when the mode is not `24h` or the snapshot is unreadable.
     */
    readonly h24State: State24hSnapshot | null;
    /** Job-mode flag from `job-shape.json` (`false` when undecided / unreadable). */
    readonly jobMode: boolean;
    /**
     * The resolved auto-compact profile: `standard` or `eager`. It is a PUBLIC
     * choice — the project setting `autoCompactProfile` or an explicit
     * `--mode`, never the 24h state machine.
     */
    readonly autoCompactProfile: AutoCompactProfile;
    /** Where that profile came from, so the answer is diagnosable. */
    readonly autoCompactProfileSource: AutoCompactProfileSource;
    /** Thresholds backing `autoCompactProfile` (display aid). */
    readonly autoCompactThresholds: {
        readonly autoFire: number;
        readonly preCompact: number;
        readonly redLine: number;
    };
}
/**
 * Read the active presence mode via the canonical lease projection.
 * Never throws.
 */
export declare function resolvePresenceMode(projectRoot: string): ResolvedPresenceMode;
/**
 * Resolve the auto-compact profile: `standard` (the v2.13.0 zero-pause
 * contract thresholds) or `eager` (the earlier-firing thresholds).
 *
 * The profile is a PUBLIC choice, resolved in one order:
 *
 *   1. an explicit `--mode` on this invocation (one call, one override)
 *   2. the project setting `autoCompactProfile`
 *   3. the default `'standard'`
 *
 * The 24h mode does NOT take part. It used to: the profile was derived from
 * the presence mode and from the 24h state machine, which made the
 * compaction cadence a private property of one mode — a 24h session
 * compacted earlier than a plain one without anybody asking for it. A
 * project that wants to compact earlier now says so with
 * `peaks preferences set --key autoCompactProfile --value eager`, and
 * nothing changes under it silently.
 *
 * The resolution itself lives in `services/code/auto-compact-profile.ts`;
 * this function keeps the name and the arity every existing caller uses.
 */
export declare function resolveAutoCompactProfile(projectRoot: string): AutoCompactProfile;
/**
 * Assemble the full stacked status. `sessionId` defaults to the
 * canonical binding when omitted.
 */
export declare function resolveModeStatus(input: {
    projectRoot: string;
    sessionId?: string | null | undefined;
}): ModeStatus;