export type MediaAttachment = {
  /** MIME type (e.g., "image/jpeg", "audio/ogg", "video/mp4"). */
  mimeType: string;
  /** Local file path to the media (preferred for CLI runtimes that accept file paths). */
  filePath?: string;
  /** Base64-encoded content (for runtimes that accept inline data). */
  base64?: string;
  /** Original URL (for reference/logging; runtimes should prefer filePath or base64). */
  sourceUrl?: string;
  /** Original filename (for display/logging). */
  fileName?: string;
};

export type AgentExecuteParams = {
  prompt: string;
  /** Media attachments to include with the prompt. */
  media?: MediaAttachment[];
  // ... existing fields
};

export type AgentMediaEvent = {
  type: "media";
  media: MediaAttachment;
};

export type AgentEvent =
  | AgentTextEvent
  | AgentMediaEvent   // ← new
  | AgentToolUseEvent
  | AgentToolResultEvent
  | AgentErrorEvent
  | AgentDoneEvent;

export type AgentRunResult = {
  text: string;
  /** Media attachments produced by the agent (non-MCP path). */
  media?: MediaAttachment[];
  // ... existing fields
};

export interface AgentRuntime {
  execute(params: AgentExecuteParams): AsyncIterable<AgentEvent>;

  /** Declare which media types this runtime can handle natively. */
  readonly mediaCapabilities?: {
    /** MIME type prefixes accepted as inbound media (e.g., ["image/", "audio/", "video/"]). */
    acceptsInbound?: string[];
    /** Whether the runtime can emit media in responses. */
    emitsOutbound?: boolean;
  };
}