/**
 * Resolve line-display mode for file-like outputs (read, grep, @file mentions).
 */

import { type EditModeSessionLike, resolveEditMode } from "./edit-mode";
import { cfgReadLineNumbers } from "../tools/settings";

export interface FileDisplayMode {
	lineNumbers: boolean;
	hashLines: boolean;
}

/** Session-like object providing settings and tool availability for display mode resolution. */
export interface FileDisplayModeSession extends EditModeSessionLike {
	/** Whether the edit tool is available. Hashlines are suppressed without it. */
	hasEditTool?: boolean;
}

/**
 * Computes effective line display mode from session settings/env.
 * Hashline mode takes precedence and implies line-addressed output everywhere.
 * Hashlines are suppressed when the edit tool is not available (e.g. scout agents),
 * when the caller signals a `raw` read, and when the source is `immutable`
 * (e.g. internal URLs like artifact://, agent://, memory:// — there is no edit
 * path that could consume the anchors). Raw output is returned as-is.
 */
export function resolveFileDisplayMode(
	session: FileDisplayModeSession,
	options?: { raw?: boolean; immutable?: boolean },
): FileDisplayMode {
	const { settings } = session;
	const hasEditTool = session.hasEditTool ?? true;
	const editMode = resolveEditMode(session);
	const usesHashLineAnchors = editMode === "hashline";
	const raw = options?.raw === true;
	const immutable = options?.immutable === true;
	const hashLines = !raw && !immutable && hasEditTool && usesHashLineAnchors;
	return {
		hashLines,
		lineNumbers: !raw && (hashLines || cfgReadLineNumbers.get(settings) === true),
	};
}