/**
 * UnifiedMessage — the discriminated union of all persistent message types.
 *
 * All messages extend MessageBase which carries identity, session,
 * and context fields at the root level.
 */

import type { TokenUsage, StopReason } from './common';
import type { ToolUseBlock, ToolResult } from './tool';

// ============================================================
// Message Base
// ============================================================

/** Sender identity attached to every message */
export interface MessageSender {
	id: string;
	name: string;
}

/** Engine account identity attached to every message */
export interface MessageAccount {
	id: number;
	name: string;
}

/** Parent references carried by every message */
export interface MessageParent {
	messageId: string | null;
	sessionId: string | null;
	toolUseId: string | null;
}

/** Model identity attached to every message */
export interface MessageModel {
	id: string;
	name: string;
}

/** Engine context attached to every message */
export interface MessageEngine {
	type: 'claude-code' | 'opencode' | 'copilot' | 'codex' | 'qwen' | 'pi' | 'cline' | 'cursor';
	provider: string;
	model: MessageModel;
	account: MessageAccount;
	/**
	 * Reasoning/thinking level applied to this turn (native per engine — see
	 * `EngineModel.capabilities.reasoningControl`). Present only when the
	 * engine/model exposes a reasoning knob; absent for engines/models without one.
	 */
	reasoningEffort?: string | null;
}

/** Common fields present on every message */
export interface MessageBase {
	createdAt: string;
	messageId: string;
	/** SDK-issued session ID. Null for messages that have no SDK session context
	 *  (e.g. user messages from the frontend, or messages where the SDK did not provide one). */
	sessionId: string | null;
	parent: MessageParent;
	engine: MessageEngine;
}

// ============================================================
// Content Blocks
// ============================================================

export interface TextBlock {
	type: 'text';
	text: string;
}

export interface ImageBlock {
	type: 'image';
	mediaType: string;
	data: string;
}

export interface DocumentBlock {
	type: 'document';
	mediaType: string;
	data: string;
	title: string | null;
}

export type UserContentBlock =
	| TextBlock
	| ToolResult
	| ImageBlock
	| DocumentBlock;

export type AssistantContentBlock =
	| TextBlock
	| ToolUseBlock;

// ============================================================
// Message Types
// ============================================================

/**
 * User-submitted message.
 * Contains text, file attachments, or tool execution results.
 */
export interface UserMessage extends MessageBase {
	type: 'user';
	sender: MessageSender;
	content: UserContentBlock[];
	synthetic: boolean;
}

/**
 * AI assistant response.
 * Contains text and/or tool invocations.
 */
export interface AssistantMessage extends MessageBase {
	type: 'assistant';
	content: AssistantContentBlock[];
	stopReason: StopReason | null;
	usage: TokenUsage | null;
}

/**
 * Reasoning/thinking content from the model.
 * Displayed as a separate collapsible bubble in the UI.
 */
export interface ReasoningMessage extends MessageBase {
	type: 'reasoning';
	text: string;
}

/**
 * Context compaction boundary marker.
 * Rendered as a visual separator when the engine compacts context.
 */
export interface CompactBoundaryMessage extends MessageBase {
	type: 'compact_boundary';
	trigger: 'manual' | 'auto';
	preTokens: number;
}

// ============================================================
// UnifiedMessage
// ============================================================

/**
 * Discriminated union of all persistent message types.
 *
 * This is the canonical format for DB storage, WebSocket transport,
 * and frontend rendering. Engine adapters convert SDK-specific
 * formats to this type.
 */
export type UnifiedMessage =
	| UserMessage
	| AssistantMessage
	| ReasoningMessage
	| CompactBoundaryMessage;