export declare const USER_WORKFLOW_TRACE_FILE = "user-workflow-trace.json";
export type UserWorkflowSpanKind = 'user_goal' | 'planning' | 'context' | 'agent_action' | 'verification' | 'decision' | 'outcome';
export type UserWorkflowStatus = 'ok' | 'warn' | 'failed' | 'skipped';
export interface UserWorkflowSpan {
    id: string;
    parentId?: string;
    kind: UserWorkflowSpanKind;
    label: string;
    status: UserWorkflowStatus;
    summary: string;
    attributes?: Record<string, unknown>;
}
export interface UserWorkflowSignal {
    code: string;
    severity: 'info' | 'warn' | 'high';
    summary: string;
    evidence?: Record<string, unknown>;
}
export interface UserWorkflowTrace {
    schemaVersion: 1;
    scope: 'user-agent-workflow';
    traceId: string;
    runId: string;
    generatedAt: number;
    goal: string;
    state: string;
    result: string;
    artifactsPath?: string;
    userJourney: {
        goal: string;
        selectedFiles: string[];
        selectedSkills: string[];
        selectedWorkflows: string[];
        selectedSpecialists: string[];
        actions: string[];
        verifyCommands: string[];
    };
    spans: UserWorkflowSpan[];
    signals: UserWorkflowSignal[];
    nextActions: string[];
}
type RunLike = Record<string, any>;
export declare function buildUserWorkflowTrace(run: RunLike): UserWorkflowTrace;
export declare function resolveUserWorkflowTracePath(artifactsPath: string): string;
export declare function readUserWorkflowTrace(artifactsPath: string): Promise<UserWorkflowTrace | undefined>;
export declare function summarizeUserWorkflowTrace(trace: UserWorkflowTrace): string;
export {};
