import type { Clock } from "./clock";
import type { FsPort } from "./fs";
import type { Timers } from "./timers";

export interface UiPort {
  notify(message: string): void;
  setStatus(key: string, message?: string): void;
  confirm(message: string): Promise<boolean>;
  /** R22/D-W2: optional interactive dialogs, present only in hosts with dialog support (TUI/RPC).
   * `undefined` returns mean Esc/timeout. Optional members keep every existing consumer (e.g.
   * ConfigStore's `Pick<UiPort, "notify">`) byte-identical. */
  select?(title: string, options: readonly string[]): Promise<string | undefined>;
  input?(title: string, placeholder?: string): Promise<string | undefined>;
}
export type CompletionMessage = { role: "user"; content: string };
export type CompletionContext = { messages: readonly CompletionMessage[] };
export type CompleteFn<Model = unknown, Result = unknown> = (model: Model, context: CompletionContext) => Promise<Result>;
export interface EntriesPort<Data = unknown> { append(type: string, data?: Data): void; branch(): readonly Data[]; }
export type IdGen = () => string;
export interface ModelRegistryPort<Model = unknown, Result = unknown> { complete: CompleteFn<Model, Result>; }
export interface ExtensionContextPort<Model = unknown, Result = unknown> {
  cwd: string; clock: Clock; timers: Timers; fs: FsPort; ui: UiPort; entries: EntriesPort; idGen: IdGen;
  modelRegistry: ModelRegistryPort<Model, Result>;
}
export type ExtensionContext<Model = unknown, Result = unknown> = ExtensionContextPort<Model, Result>;
export type EventHandler = (...args: readonly unknown[]) => unknown | Promise<unknown>;
export interface ExtensionApiPort { on(event: string, handler: EventHandler): void; registerCommand(name: string, handler: EventHandler): void; }