import type { Usage } from '../execution/Usage';
import type { CodexLoginMethod } from './codexLoginMethod';
/**
 * File suffix appended to one answered message book to store its run report sidecar.
 *
 * For example `messages/finished/2026-07-16-thread.book` is reported in
 * `messages/finished/2026-07-16-thread.book.report.json`.
 *
 * @private internal constant of the agent folder convention
 */
export declare const AGENT_MESSAGE_RUN_REPORT_FILE_SUFFIX = ".report.json";
/**
 * Report describing how one queued agent message was answered by a CLI harness runner.
 *
 * The agent runner writes it next to the answered message book so consumers
 * (for example the Agents Server task details) can show which runner, authentication
 * method and usage one answer cost without re-parsing the runner output.
 *
 * Note: [🚉] This is fully serializable as JSON
 *
 * @private internal type of the agent folder convention
 */
export type AgentMessageRunReport = {
    /**
     * Report schema version for forward compatibility.
     */
    readonly version: 1;
    /**
     * Name of the harness runner which answered the message, for example `codex` or `claude-code`.
     */
    readonly runnerName: string;
    /**
     * Model identifier used by the runner, when known.
     */
    readonly modelName?: string;
    /**
     * Authentication method the runner used, when it can be determined.
     *
     * Currently only the OpenAI Codex runner reports this (its ChatGPT account vs. `OPENAI_API_KEY`);
     * other runners leave it `undefined`.
     */
    readonly loginMethod?: CodexLoginMethod;
    /**
     * Usage statistics of the run (price, token counts, duration).
     */
    readonly usage: Usage;
};
/**
 * Builds the run-report sidecar path for one message book path.
 *
 * Works for absolute and relative paths because the suffix is simply appended.
 *
 * @private internal utility of the agent folder convention
 */
export declare function buildAgentMessageRunReportPath(messageFilePath: string): string;
/**
 * Serializes one run report into the stable JSON format persisted next to the answered message book.
 *
 * @private internal utility of the agent folder convention
 */
export declare function serializeAgentMessageRunReport(report: AgentMessageRunReport): string;
/**
 * Validates one already-parsed JSON value as a run report.
 *
 * @returns The typed report, or `null` when the value does not match the expected shape,
 * so consumers can silently skip malformed or foreign sidecar files.
 *
 * @private internal utility of the agent folder convention
 */
export declare function normalizeAgentMessageRunReport(value: unknown): AgentMessageRunReport | null;
/**
 * Parses one run-report sidecar file content.
 *
 * @returns The typed report, or `null` when the content is not valid JSON or does not match the expected shape.
 *
 * @private internal utility of the agent folder convention
 */
export declare function parseAgentMessageRunReport(reportFileContent: string): AgentMessageRunReport | null;