ThunderAI/claude-spec/05-options.md

Options & Settings System

Overview

All extension preferences are stored in browser.storage.local. Defaults and the full list of valid keys are defined in options/mzta-options-default.js.

Key Exports from mzta-options-default.js

Export	Description
prefs_default	All preference keys with their default values
integration_options_config	Per-provider API settings structure
getDynamicSettingsDefaults(keysFilter)	Returns per-special-prompt integration defaults
getDynamicSettingValue(prefs, prefix, settingName)	Reads a prefixed setting for a special prompt

Settings Structure

Global Integration Settings

Stored flat in prefs_default with {provider}_{key} naming:

chatgpt_api_key, chatgpt_model, chatgpt_developer_messages, chatgpt_temperature, chatgpt_store
ollama_host, ollama_model, ollama_num_ctx, ollama_temperature, ollama_think
openai_comp_host, openai_comp_model, openai_comp_api_key, openai_comp_use_v1, openai_comp_chat_name, openai_comp_temperature
google_gemini_api_key, google_gemini_model, google_gemini_system_instruction, google_gemini_thinking_budget, google_gemini_temperature
anthropic_api_key, anthropic_model, anthropic_version, anthropic_max_tokens, anthropic_system_prompt, anthropic_temperature

Plus the global connection selector:

connection_type   (default: 'chatgpt_web')
use_specific_integration   (default: false)

Special Prompt Integration Overrides

The 6 special prompts (add_tags, spamfilter, summarize, get_calendar_event, get_task, translate) each get their own use_specific_integration and connection_type keys:

{prefix}_use_specific_integration   (default: false)
{prefix}_connection_type            (default: 'chatgpt_api')

These are generated programmatically at the bottom of mzta-options-default.js using special_prompts_with_integration array.

UI & Feature Preferences

Key	Default	Description
do_debug	false	Enable debug logging
chatgpt_win_height	800	ChatGPT window height
chatgpt_win_width	700	ChatGPT window width
chatgpt_win_top	''	Window top position
chatgpt_win_left	''	Window left position
chatgpt_win_save_position	false	Remember window position
default_chatgpt_lang	''	Force response language
default_sign_name	''	Default signature name
reply_type	'reply_all'	Default reply type
composing_plain_text	false	Use plain text in compose
chatgpt_web_model	''	ChatGPT Web model override
chatgpt_web_tempchat	false	Use temporary chat
chatgpt_web_project	''	ChatGPT Web project
chatgpt_web_custom_gpt	''	Custom GPT URL
chatgpt_web_load_wait_time	1000	Wait time (ms) for ChatGPT page
dynamic_menu_force_enter	false	Force Enter to submit in popup
dynamic_menu_order_alphabet	true	Sort prompts alphabetically
placeholders_use_default_value	false	Use placeholder defaults when empty
max_prompt_length	30000	Max prompt string length

Feature Flags

Key	Default	Description
add_tags	false	Enable auto-tagging feature
add_tags_maxnum	3	Max tags to apply
add_tags_hide_exclusions	false	Hide excluded tags from menu
add_tags_exclusions_exact_match	false	Exact match for exclusions
add_tags_first_uppercase	true	Capitalize first letter of tags
add_tags_force_lang	true	Force language for tags
add_tags_auto	false	Auto-tag on message open
add_tags_auto_force_existing	false	Only use existing tags
add_tags_auto_only_inbox	true	Auto-tag only inbox messages
add_tags_auto_uselist	false	Use tag allow-list
add_tags_auto_uselist_list	''	Tag allow-list content
add_tags_enabled_accounts	[]	Accounts where auto-tag is active
get_calendar_event	true	Enable calendar event extraction
get_calendar_event_from_clipboard	false	Enable calendar from clipboard
get_task	true	Enable task creation
calendar_enforce_timezone	false	Force specific timezone
calendar_timezone	''	Timezone to enforce
calendar_no_selection	false	Skip selection prompt
spamfilter	false	Enable spam filter
spamfilter_threshold	70	Spam confidence threshold (%)
spamfilter_enabled_accounts	[]	Accounts where spam filter is active
spamfilter_show_msg_panel	true	Show info panel on spam detection
summarize	false	Enable email summarization
summarize_auto	1	Auto-summarize mode: 0 = disabled, 1 = manual (show "click to generate" button), 2 = automatic (generate on message open), 3 = generate on email receive (background pre-cache via onNewMailReceived, no UI during generation)
summarize_display_mode	'inline'	Where to display summaries: 'inline' = message pane banner, 'webchat' = AI chat window. Note: summarize_auto = 2 and summarize_auto = 3 always use inline regardless of this setting.
summarize_max_display_length	0	Maximum characters shown in inline summary before truncation. 0 = no limit (show full text). When set, text is truncated at a word boundary and a "See more"/"See less" toggle link is shown.
translate	true	Enable email translation
translate_auto	0	Auto-translate mode: 0 = disabled, 1 = manual (show button), 2 = automatic (translate on message open), 3 = generate on email receive (background pre-cache via onNewMailReceived, no UI during generation)
translate_display_mode	'inline'	Where to display translations: 'inline' = message pane banner, 'webchat' = AI chat window. Note: translate_auto = 2 and translate_auto = 3 always use inline regardless of this setting.
translate_max_display_length	0	Maximum characters shown in inline translation before truncation. 0 = no limit (show full text). When set, text is truncated at a word boundary and a "See more"/"See less" toggle link is shown.
translate_lang	''	Target language for translation. Falls back to default_chatgpt_lang if empty.
translate_summary_translation	false	Links translation and summary features. When translating, also translates the existing cached summary. When summarizing, uses the existing cached translation as input instead of the original email body.

Summarize Settings Page (pages/summarize/)

The summarize settings page provides:

1. Specific integration checkbox — enables per-feature API override (like other special prompts)
2. Auto-summarize dropdown (summarize_auto) — three modes:
   • 0 (Disabled) — no inline summaries
   • 1 (Manual) — shows a "Click to generate summary" button in message display
   • 2 (Automatic) — generates summary immediately when message is opened
3. Display mode dropdown (summarize_display_mode) — controls where summaries are shown:
   • 'inline' — summary banner in the message pane (default)
   • 'webchat' — opens the AI chat window
   • Note: summarize_auto = 2 always generates inline regardless of this setting. Context menu summarize with multiple messages always falls back to webchat.
4. Max display length (summarize_max_display_length) — number input, limits inline summary text to N characters. 0 = no limit. When truncated, a "See more"/"See less" toggle link is appended.
5. Three editable prompts (used by context menu summarize and webchat mode):
   • Summarize instruction prompt (prompt_summarize)
   • Email template prompt (prompt_summarize_email_template)
   • Email separator prompt (prompt_summarize_email_separator)
   • Each has Save/Reset buttons and placeholder autocomplete
   • Default text comes from i18n strings (prompt_summarize_full_text, etc.)

Translate Settings Page (pages/translate/)

The translate settings page provides:

1. Specific integration checkbox — enables per-feature API override (like other special prompts)
2. Auto-translate dropdown (translate_auto) — three modes:
   • 0 (Disabled) — no inline translations
   • 1 (Manual) — shows a "Get AI Translation" button in message display
   • 2 (Automatic) — generates translation immediately when message is opened
3. Display mode dropdown (translate_display_mode) — controls where translations are shown:
   • 'inline' — translation banner in the message pane (default)
   • 'webchat' — opens the AI chat window with a "Save as Translation" button
   • Note: translate_auto = 2 always generates inline regardless of this setting.
4. Max display length (translate_max_display_length) — number input, limits inline translation text to N characters. 0 = no limit. When truncated, a "See more"/"See less" toggle link is appended.
5. Target language (translate_lang) — text input for the destination language. If empty, falls back to default_chatgpt_lang.
6. One editable prompt — the translation instruction prompt (prompt_translate_this) with Save/Reset buttons and placeholder autocomplete. Default text comes from i18n string prompt_translate_this_full_text.
7. Summary Translation checkbox (translate_summary_translation) — links translation and summary features. When enabled: translating an email also translates the cached summary (if present), and summarizing an email uses the cached translation (if present) as input instead of the original email body.

Adding a New Preference

1. Add the key and default value to prefs_default in options/mzta-options-default.js
2. Add UI control to options/mzta-options.html
3. Add load/save logic to options/mzta-options.js
4. Add i18n label to _locales/en/messages.json
5. Read the pref in the relevant module via browser.storage.local.get()

Reading Preferences at Runtime

const prefs = await browser.storage.local.get(prefs_default);
// prefs now contains all keys with defaults for any unset values
const myPref = prefs.my_new_pref;