1export interface CliOptions {
2  prompt: string;
3  promptFile: string | null;
4  outputPath: string;
5  aspect: string;
6  refImages: string[];
7  timeoutMs: number;
8  retries: number;
9  retryDelayMs: number;
10  cacheDir: string | null;
11  logFile: string | null;
12  verbose: boolean;
13}
14 
15export interface ToolCall {
16  id: string;
17  tool: string;
18  status: string;
19  command?: string;
20}
21 
22export interface TokenUsage {
23  input: number;
24  cached_input: number;
25  output: number;
26  reasoning: number;
27}
28 
29export interface CodexRunResult {
30  threadId: string | null;
31  toolCalls: ToolCall[];
32  agentMessage: string | null;
33  usage: TokenUsage | null;
34  rawLogPath: string;
35  durationMs: number;
36}
37 
38export interface GenerateResult {
39  status: "ok" | "error";
40  path: string;
41  bytes: number;
42  elapsed_seconds: number;
43  thread_id: string | null;
44  attempts: number;
45  cached: boolean;
46  usage: TokenUsage | null;
47  tool_calls: { tool: string; status: string }[];
48  error?: string;
49  error_kind?: ErrorKind;
50}
51 
52export type ErrorKind =
53  | "codex_not_installed"
54  | "invalid_args"
55  | "prompt_file_missing"
56  | "spawn_failed"
57  | "timeout"
58  | "no_image_gen_tool_use"
59  | "output_missing"
60  | "invalid_png"
61  | "agent_refused"
62  | "lock_busy";
63 
64export const RETRYABLE: ReadonlySet<ErrorKind> = new Set([
65  "spawn_failed",
66  "timeout",
67  "no_image_gen_tool_use",
68  "output_missing",
69  "invalid_png",
70  "agent_refused",
71]);
72 
73export class GenError extends Error {
74  attempts?: number;
75  constructor(public kind: ErrorKind, message: string, public retryable?: boolean) {
76    super(message);
77    this.retryable = retryable ?? RETRYABLE.has(kind);
78  }
79}
80