<?php

/**
 * Additional Plugin Constants
 * (Base constant defined in the main plugin php file)
 * @package AgentMod
 * @subpackage Common
 * @since 1.0.0
 */

namespace AgentMod\Common;

defined('ABSPATH') || exit;

class Constants
{
	public const NAME = 'agent_mod';
	public const INCLUDES_PATH = AGENT_MOD_PATH . 'includes/';
	public const INCLUDES_URL = AGENT_MOD_URL . '/includes/';
	public const AUTHOR = 'Kadim Gültekin';
	public const AUTHOR_URL = 'https://kadimgultekin.com/';
	public const PLUGIN_URL = 'https://kadimgultekin.com/';
	public const EMAIL = 'info@kadimgultekin.com';
	public const PHP_VERSION = '7.4';
	public const WP_VERSION = '7.0';

	/**
	 * Default AI provider id.
	 *
	 * An empty string means "auto": the orchestrator lets the WordPress AI Client
	 * pick whichever configured provider (e.g. Google, OpenAI, Anthropic) can
	 * handle the request, instead of forcing a single provider.
	 *
	 * @since 1.0.0
	 */
	public const AI_PROVIDER_DEFAULT = '';

	/**
	 * REST namespace for the plugin.
	 *
	 * @since 1.0.0
	 */
	public const REST_NAMESPACE = 'agent-mod/v1';

	/**
	 * Default maximum number of tool-calling iterations.
	 *
	 * @since 1.0.0
	 */
	public const AI_MAX_TOOL_CALLS = 30;

	/**
	 * Maximum results per ability call that returns a list of posts or items.
	 *
	 * @since 1.0.0
	 */
	public const AI_MAX_SEARCH_RESULTS = 20;

	/**
	 * Maximum posts whose full body content an agent may read in a single turn.
	 *
	 * @since 1.0.0
	 */
	public const AI_MAX_FULL_CONTENT_POSTS = 5;

	/**
	 * Maximum decoded size (in bytes) allowed for a single chat attachment.
	 *
	 * @since 1.0.0
	 */
	public const AI_ATTACHMENT_MAX_BYTES = 5242880; // 5 MB.

	/**
	 * Maximum number of attachments allowed per chat turn.
	 *
	 * @since 1.0.0
	 */
	public const AI_ATTACHMENT_MAX_COUNT = 5;

	/**
	 * MIME types accepted as chat attachments.
	 *
	 * Provider-agnostic allow-list. Whether a given provider can actually consume
	 * a type (e.g. vision for images) is the provider's concern; this only guards
	 * what AgentMod is willing to forward.
	 *
	 * @since 1.0.0
	 * @var string[]
	 */
	public const AI_ATTACHMENT_MIME_TYPES = [
		'image/png',
		'image/jpeg',
		'image/gif',
		'image/webp',
		'application/pdf',
		'text/plain',
		'text/markdown',
		'text/csv',
	];

	/**
	 * Default name of AgentMod Assistant.
	 *
	 * @since 1.0.5
	 * @var string
	 */
	public const AI_AGENT_DEFAULT_NAME = 'AgentMod Assistant';

	/**
	 * Default context enabled of AgentMod Assistant.
	 *
	 * @since 1.0.5
	 * @var bool
	 */
	public const AI_CONTEXT_ENABLED = true;

	/**
	 * Default web search enabled state of AgentMod Assistant.
	 *
	 * Opt-in by default: web search adds latency and cost, and native support
	 * depends on the selected provider/model.
	 *
	 * @since 1.0.6
	 * @var bool
	 */
	public const AI_WEB_SEARCH_ENABLED = false;

	/**
	 * Default role of AgentMod Assistant.
	 *
	 * @since 1.0.5
	 * @var string
	 */
	public const AI_AGENT_DEFAULT_ROLE = 'You are a WordPress expert AI assistant. You can create content, design, and manage the website using abilities.';

	/**
	 * Default goal of AgentMod Assistant.
	 *
	 * @since 1.0.5
	 * @var string
	 */
	public const AI_AGENT_DEFAULT_GOAL = 'Your goal is completing requests with high accuracy and efficiency and making no mistakes.';

	// -------------------------------------------------------------------------
	// Filtered getters — use these instead of the raw constants so that
	// agent-mod-pro (or any third party) can override values via hooks.
	// -------------------------------------------------------------------------

	/**
	 * Returns the canonical default base system prompt.
	 *
	 * These core behaviour directives ship as the default value of the
	 * "Base System Prompt" setting so site owners can fully manage them.
	 *
	 * @return string
	 * @since 1.0.0
	 */
	public static function aiDefaultSystemPrompt(): string
	{
		$directives = [
			__(
				'State-changing operations are automatically intercepted by the system, which shows the user an approval dialog before they run. Do not ask for permission in chat — request the needed tool calls directly. When a task requires several write operations, request them in sequence until the whole task is complete; never stop mid-task to ask whether to continue.',
				'agent-mod'
			),
			__(
				'When a user request is ambiguous or missing required details, ask one short clarifying question before calling any tools. Do not assume intent.',
				'agent-mod'
			),
			__(
				'When a tool can answer the user accurately, call it before responding. Base your answers on tool results rather than guessing.',
				'agent-mod'
			),
		];

		return implode("\n\n", $directives);
	}

	/**
	 * Default chat panel preset prompts.
	 *
	 * @since 1.0.7
	 * @return array<array{label: string, prompt: string}>
	 */
	public static function aiDefaultPresetPrompts(): array
	{
		return [
			[
				'label' => __('Create a pattern', 'agent-mod'),
				'prompt' => __('Create a hero section pattern includes ...... via using @agent-mod/create-pattern  tool.', 'agent-mod'),
			],
			[
				'label' => __('Create a post', 'agent-mod'),
				'prompt' => __('Create a post about ..... via using @agent-mod/create-post tool. Details: .....', 'agent-mod'),
			],
			[
				'label' => __('Install a slider plugin', 'agent-mod'),
				'prompt' => __('Install a slider plugin via using @agent-mod/install-plugin tool. The plugin should provide a block to create slides with core blocks.', 'agent-mod'),
			],
			[
				'label' => __('Change time zone of the site', 'agent-mod'),
				'prompt' => __('Change site time zone as "Europe/Istanbul".', 'agent-mod'),
			],
			[
				'label' => __('Get environment info', 'agent-mod'),
				'prompt' => __('What is the environment information of my web site? Use related ability tools to fetch environment info.', 'agent-mod'),
			],
		];
	}
}