@exaudeus/workrail 3.79.3 → 3.81.0

package/dist/cli/commands/worktrain-diagnose.d.ts

@@ -0,0 +1,114 @@
+export interface DiagnosticNotFound {
+    readonly kind: 'NOT_FOUND';
+    readonly sessionIdQuery: string;
+    readonly daysBack: number;
+}
+export interface DiagnosticAmbiguous {
+    readonly kind: 'AMBIGUOUS';
+    readonly sessionIdQuery: string;
+    readonly candidates: readonly string[];
+}
+export interface DiagnosticSuccess {
+    readonly kind: 'SUCCESS';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly metrics: SessionMetrics;
+}
+export interface DiagnosticConfigError {
+    readonly kind: 'CONFIG_ERROR';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly detail: string;
+    readonly detailTruncated: boolean;
+    readonly metrics: SessionMetrics;
+    readonly steps: readonly StepRecord[];
+    readonly processState: ProcessState;
+}
+export interface DiagnosticWorkflowStuck {
+    readonly kind: 'WORKFLOW_STUCK';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly stuckReason: 'repeated_tool_call' | 'no_progress' | 'stall';
+    readonly stuckDetail: string;
+    readonly toolName?: string;
+    readonly argsSummary?: string;
+    readonly metrics: SessionMetrics;
+    readonly steps: readonly StepRecord[];
+    readonly processState: ProcessState;
+}
+export interface DiagnosticWorkflowTimeout {
+    readonly kind: 'WORKFLOW_TIMEOUT';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly timeoutReason: 'wall_clock' | 'max_turns' | 'unknown';
+    readonly stepAdvances: number;
+    readonly metrics: SessionMetrics;
+    readonly steps: readonly StepRecord[];
+    readonly processState: ProcessState;
+}
+export interface DiagnosticInfraError {
+    readonly kind: 'INFRA_ERROR';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly infraReason: 'daemon_shutdown' | 'daemon_killed' | 'aborted' | 'network' | 'unknown';
+    readonly detail: string;
+    readonly metrics: SessionMetrics;
+    readonly steps: readonly StepRecord[];
+    readonly processState: ProcessState;
+}
+export interface DiagnosticOrphaned {
+    readonly kind: 'ORPHANED';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly lastEventKind: string | null;
+    readonly lastEventTs: number | null;
+    readonly metrics: SessionMetrics;
+    readonly steps: readonly StepRecord[];
+}
+export interface DiagnosticDefault {
+    readonly kind: 'DEFAULT';
+    readonly sessionId: string;
+    readonly workflowId: string;
+    readonly startedAt: number | null;
+    readonly durationMs: number;
+    readonly outcome: string;
+    readonly detail: string;
+    readonly rawEventLine: string;
+    readonly metrics: SessionMetrics;
+    readonly steps: readonly StepRecord[];
+    readonly processState: ProcessState;
+}
+export type DiagnosticResult = DiagnosticNotFound | DiagnosticAmbiguous | DiagnosticSuccess | DiagnosticConfigError | DiagnosticWorkflowStuck | DiagnosticWorkflowTimeout | DiagnosticInfraError | DiagnosticOrphaned | DiagnosticDefault;
+export interface SessionMetrics {
+    readonly llmTurns: number;
+    readonly stepAdvances: number;
+    readonly toolCallsTotal: number;
+    readonly toolCallsFailed: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+}
+export interface StepRecord {
+    readonly index: number;
+    readonly status: 'completed' | 'terminal' | 'not_reached';
+    readonly turns: number;
+}
+export type ProcessState = 'STOPPED' | 'RUNNING' | 'UNKNOWN';
+export declare function parseDaemonEvents(sessionIdQuery: string, eventsDir: string, daysBack: number, readFile: (path: string) => string | null): DiagnosticResult;
+export interface FormatOptions {
+    readonly ascii?: boolean;
+    readonly noColor?: boolean;
+}
+export declare function formatDiagnosticCard(result: DiagnosticResult, opts?: FormatOptions): string;
+export declare function formatDiagnosticJson(result: DiagnosticResult): string;