export type JournalEntryState = "pending" | "settled" | "interrupted";

export interface JournalPaths {
  agentDirectory: string;
  journalDirectory: string;
  databasePath: string;
  notesDirectory: string;
}

export interface BeginJournalEntry {
  piSessionId: string;
  userEntryId: string;
  sessionFile?: string;
  cwd: string;
  request: string;
  startedAt: string;
  localDate: string;
  localTime: string;
}

export type PendingJournalEntry = BeginJournalEntry;

export interface DirtyJournalDate {
  localDate: string;
  revision: number;
}

export interface TokenFacts {
  inputTokens: number;
  outputTokens: number;
  cacheReadTokens: number;
  cacheWriteTokens: number;
  totalTokens: number;
}

export interface ModelFacts extends TokenFacts {
  provider: string;
  model: string;
  responses: number;
  totalCost: number;
}

export interface ToolFacts extends TokenFacts {
  name: string;
  executions: number;
  failures: number;
  totalCost: number;
}

export interface SettleJournalEntry {
  piSessionId: string;
  userEntryId: string;
  settledAt: string;
  state?: Exclude<JournalEntryState, "pending">;
  models: readonly ModelFacts[];
  tools: readonly ToolFacts[];
}

export interface RecordedJournalEntry {
  id: number;
  localDate: string;
  state: Exclude<JournalEntryState, "pending">;
}

export interface DailyJournalEntry {
  id: number;
  piSessionId: string;
  userEntryId: string;
  sessionFile?: string;
  cwd: string;
  request: string;
  state: Exclude<JournalEntryState, "pending">;
  startedAt: string;
  localTime: string;
  models: readonly ModelFacts[];
  tools: readonly ToolFacts[];
}

export interface JournalSearchQuery {
  query: string;
  after?: string;
  before?: string;
  cwd?: string;
  model?: string;
  tool?: string;
  limit?: number;
}

export interface JournalSearchResult extends DailyJournalEntry {
  localDate: string;
  snippet: string;
  rank: number;
}

/** The complete journal interface used by recording, notes, and search. */
export interface Journal {
  readonly paths: JournalPaths;
  beginEntry(input: BeginJournalEntry): void;
  listPendingEntries(piSessionId: string): readonly PendingJournalEntry[];
  settleEntry(input: SettleJournalEntry): RecordedJournalEntry | undefined;
  interruptPendingEntries(piSessionId: string, settledAt: string): readonly RecordedJournalEntry[];
  isProjectExcluded(cwd: string): boolean;
  setProjectExcluded(cwd: string, excluded: boolean): void;
  listDirtyDates(): readonly DirtyJournalDate[];
  markAllNotesDirty(): void;
  markNoteClean(localDate: string, revision: number): void;
  listDailyEntries(localDate: string): readonly DailyJournalEntry[];
  search(query: JournalSearchQuery): readonly JournalSearchResult[];
  related(entryId: number, limit?: number): readonly JournalSearchResult[];
  close(): void;
}