import { z } from 'zod';
import { type JsonObject } from '../depot/shape.js';
/**
 * `GetJob`, `GetAttempt` and `GetWorkflow` all open with the same flattened parent context
 * (`runStatus`, `workflowName`, `jobErrorMessage`, ...) before the object itself. Verified live
 * 2026-09-06; the field names below are the ones Depot returned, with unprefixed and nested
 * spellings accepted as fallbacks because depot.ci.v1 publishes no schema.
 */
/** Workflow and job names come from YAML; keep them short when echoed into prose. */
export declare const CI_NAME_CHAR_LIMIT = 120;
export declare const runContextSchema: z.ZodObject<{
    runId: z.ZodOptional<z.ZodString>;
    repo: z.ZodOptional<z.ZodString>;
    ref: z.ZodOptional<z.ZodString>;
    sha: z.ZodOptional<z.ZodString>;
    headSha: z.ZodOptional<z.ZodString>;
    trigger: z.ZodOptional<z.ZodString>;
    status: z.ZodOptional<z.ZodString>;
    createdAt: z.ZodOptional<z.ZodString>;
    startedAt: z.ZodOptional<z.ZodString>;
    finishedAt: z.ZodOptional<z.ZodString>;
    durationSeconds: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>;
export declare const workflowContextSchema: z.ZodObject<{
    workflowId: z.ZodOptional<z.ZodString>;
    name: z.ZodOptional<z.ZodString>;
    status: z.ZodOptional<z.ZodString>;
    createdAt: z.ZodOptional<z.ZodString>;
    startedAt: z.ZodOptional<z.ZodString>;
    finishedAt: z.ZodOptional<z.ZodString>;
    durationSeconds: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>;
export declare const attemptDetailSchema: z.ZodObject<{
    attemptId: z.ZodOptional<z.ZodString>;
    attempt: z.ZodOptional<z.ZodNumber>;
    status: z.ZodOptional<z.ZodString>;
    conclusion: z.ZodOptional<z.ZodString>;
    errorMessage: z.ZodOptional<z.ZodString>;
    errorMessageTruncated: z.ZodOptional<z.ZodBoolean>;
    sandboxId: z.ZodOptional<z.ZodString>;
    sessionId: z.ZodOptional<z.ZodString>;
    createdAt: z.ZodOptional<z.ZodString>;
    dispatchedAt: z.ZodOptional<z.ZodString>;
    startedAt: z.ZodOptional<z.ZodString>;
    finishedAt: z.ZodOptional<z.ZodString>;
    durationSeconds: z.ZodOptional<z.ZodNumber>;
    isCurrent: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strip>;
export declare const jobDetailSchema: z.ZodObject<{
    jobId: z.ZodOptional<z.ZodString>;
    jobKey: z.ZodOptional<z.ZodString>;
    jobDisplayName: z.ZodOptional<z.ZodString>;
    status: z.ZodOptional<z.ZodString>;
    conclusion: z.ZodOptional<z.ZodString>;
    errorMessage: z.ZodOptional<z.ZodString>;
    errorMessageTruncated: z.ZodOptional<z.ZodBoolean>;
    createdAt: z.ZodOptional<z.ZodString>;
    dispatchedAt: z.ZodOptional<z.ZodString>;
    startedAt: z.ZodOptional<z.ZodString>;
    finishedAt: z.ZodOptional<z.ZodString>;
    durationSeconds: z.ZodOptional<z.ZodNumber>;
    currentAttemptId: z.ZodOptional<z.ZodString>;
    currentAttempt: z.ZodOptional<z.ZodNumber>;
    runsOn: z.ZodArray<z.ZodString>;
    strategy: z.ZodObject<{
        jobTotal: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>;
}, z.core.$strip>;
export type RunContext = z.infer<typeof runContextSchema>;
export type WorkflowContext = z.infer<typeof workflowContextSchema>;
export type AttemptDetail = z.infer<typeof attemptDetailSchema>;
export type JobDetail = z.infer<typeof jobDetailSchema>;
export declare function parseRunContext(source: JsonObject): RunContext;
export declare function parseWorkflowContext(source: JsonObject): WorkflowContext;
export declare function parseAttemptDetail(source: JsonObject): AttemptDetail;
/**
 * Reads the job fields from either a `GetJob`/`GetAttempt` document (where they carry a `job`
 * prefix beside the run and workflow fields) or a job entry inside `GetWorkflow` (bare names).
 */
export declare function parseJobDetail(source: JsonObject): JobDetail;
export declare function parseAttempts(source: JsonObject): AttemptDetail[];
/** Highest attempt number first; Depot lists them oldest first. Stable for equal numbers. */
export declare function newestFirst<T extends {
    attempt?: number | undefined;
}>(attempts: readonly T[]): T[];
export declare function isFailed(node: {
    status?: string | undefined;
    conclusion?: string | undefined;
}): boolean;
/** "failed (conclusion failure)" when Depot reports both and they differ; one word otherwise. */
export declare function formatState(node: {
    status?: string | undefined;
    conclusion?: string | undefined;
}): string;
/** Names from workflow YAML are untrusted: quote them and keep them short. */
export declare function quoteName(name: string | undefined, fallback: string): string;
/** Error text is CI output: one line, JSON-quoted so embedded newlines and quotes stay visible. */
export declare function quoteError(message: string): string;
export declare function describeRun(run: RunContext): string;
export declare function describeWorkflow(workflow: WorkflowContext): string;
/** One line per attempt, as rendered under a job in every tool that lists attempts. */
export declare function describeAttempt(attempt: AttemptDetail): string;
//# sourceMappingURL=ci-detail.d.ts.map