Agent Zero AI framework
Polish onboarding and email setup UX
Alessandro061b43298b3d
diff --git a/plugins/_email_integration/default_config.yaml b/plugins/_email_integration/default_config.yamlindex 557bad0ff..4a5a5807e 100644--- a/plugins/_email_integration/default_config.yaml+++ b/plugins/_email_integration/default_config.yaml@@ -2,6 +2,7 @@ handlers: []# Example handler:# - name: support# enabled: true+# provider: gmail# account_type: imap# imap_server: imap.gmail.com# imap_port: 993diff --git a/plugins/_email_integration/webui/config.html b/plugins/_email_integration/webui/config.htmlindex 4e70a913b..ea3a78239 100644--- a/plugins/_email_integration/webui/config.html+++ b/plugins/_email_integration/webui/config.html@@ -50,209 +50,243 @@<template x-if="$store.emailConfig.editing === idx"><div class="email-card-body">- <div class="email-intro-copy">- <div x-text="$store.emailConfig.providerHint(handler)"></div>- <template x-if="$store.emailConfig.providerHelpUrl(handler)">- <a class="email-intro-link"- :href="$store.emailConfig.providerHelpUrl(handler)"- target="_blank"- rel="noopener"- x-text="$store.emailConfig.providerHelpLabel(handler)"></a>- </template>- </div>-- <div class="field">- <div class="field-label">- <div class="field-title">Turn on this inbox</div>- <div class="field-description">Enable when you are ready for Agent Zero to start- checking mail.</div>- </div>- <div class="field-control">- <label class="toggle">- <input type="checkbox" x-model="handler.enabled" />- <span class="toggler"></span>- </label>+ <div class="email-provider-panel"+ :class="{ 'has-provider': $store.emailConfig.hasProvider(handler) }">+ <div class="email-provider-topline">+ <div class="email-provider-copy">+ <div class="email-provider-title"+ x-text="$store.emailConfig.hasProvider(handler) ? $store.emailConfig.providerLabel($store.emailConfig.providerValue(handler)) : 'Choose your email provider'">+ </div>+ <div class="email-provider-description"+ x-text="$store.emailConfig.hasProvider(handler) ? $store.emailConfig.providerHint(handler) : 'Pick a provider and Agent Zero will prepare the usual incoming and outgoing mail settings.'">+ </div>+ <template x-if="$store.emailConfig.providerHelpUrl(handler)">+ <a class="email-intro-link"+ :href="$store.emailConfig.providerHelpUrl(handler)"+ target="_blank"+ rel="noopener"+ x-text="$store.emailConfig.providerHelpLabel(handler)"></a>+ </template>+ </div>+ <template x-if="$store.emailConfig.hasProvider(handler)">+ <button type="button" class="btn btn-field email-change-provider"+ @click.stop="$store.emailConfig.changeProvider(idx)"+ x-text="$store.emailConfig.showProviderChoices(handler, idx) ? 'Done' : 'Change'">+ </button>+ </template></div>- </div>- <div class="field">- <div class="field-label">- <div class="field-title">Provider</div>- <div class="field-description">Pick the provider first. We will fill in the- common server settings for you.</div>- </div>- <div class="field-control">- <select :value="$store.emailConfig.providerValue(handler)"- @change="$store.emailConfig.applyProvider(handler, $event.target.value)">- <option value="">Choose a provider</option>- <option value="gmail">Gmail</option>- <option value="icloud">iCloud Mail</option>- <option value="microsoft365">Outlook / Microsoft 365</option>- <option value="yahoo">Yahoo Mail</option>- <option value="exchange">Exchange</option>- <option value="custom-imap">Custom IMAP</option>- </select>+ <div class="email-provider-grid"+ x-show="$store.emailConfig.showProviderChoices(handler, idx)">+ <template x-for="provider in $store.emailConfig.providerOptions"+ :key="provider.value">+ <button type="button" class="email-provider-option"+ :class="($store.emailConfig.providerValue(handler) === provider.value ? 'is-selected ' : '') + 'logo-' + provider.logo"+ :aria-pressed="$store.emailConfig.providerValue(handler) === provider.value ? 'true' : 'false'"+ :title="provider.label"+ @click.stop="$store.emailConfig.selectProvider(handler, provider.value, idx)">+ <span class="email-provider-logo" aria-hidden="true">+ <template x-if="provider.logo === 'microsoft365'">+ <span class="email-microsoft-mark">+ <span></span>+ <span></span>+ <span></span>+ <span></span>+ </span>+ </template>+ <template+ x-if="provider.logo !== 'microsoft365' && (provider.logo === 'icloud' || provider.logo === 'custom-imap')">+ <span class="material-symbols-outlined"+ x-text="provider.logoText"></span>+ </template>+ <template+ x-if="provider.logo !== 'microsoft365' && provider.logo !== 'icloud' && provider.logo !== 'custom-imap'">+ <span x-text="provider.logoText"></span>+ </template>+ </span>+ <span class="email-provider-name" x-text="provider.label"></span>+ <span class="email-provider-hint" x-text="provider.hint"></span>+ </button>+ </template></div></div>- <div class="field">- <div class="field-label">- <div class="field-title">Email address</div>- <div class="field-description">Usually the full address for this inbox.</div>- </div>- <div class="field-control">- <input type="text" x-model="handler.username"- @input="$store.emailConfig.maybeAutoname(handler)"- placeholder="[email protected]" />+ <div class="email-post-provider" x-show="$store.emailConfig.hasProvider(handler)">+ <div class="field">+ <div class="field-label">+ <div class="field-title">Turn on this inbox</div>+ <div class="field-description">Enable when you are ready for Agent Zero to+ start checking mail.</div>+ </div>+ <div class="field-control">+ <label class="toggle">+ <input type="checkbox" x-model="handler.enabled" />+ <span class="toggler"></span>+ </label>+ </div></div>- </div>- <div class="field">- <div class="field-label">- <div class="field-title">Password</div>- <div class="field-description">An app password is best. Many mail providers- block regular account passwords.</div>- </div>- <div class="field-control">- <input type="password" x-model="handler.password" />+ <div class="field">+ <div class="field-label">+ <div class="field-title">Email address</div>+ <div class="field-description">Usually the full address for this inbox.</div>+ </div>+ <div class="field-control">+ <input type="text" x-model="handler.username"+ @input="$store.emailConfig.maybeAutoname(handler)"+ placeholder="[email protected]" />+ </div></div>- </div>- <template x-if="$store.emailConfig.showExchangeServer(handler)">- <div>- <div class="field">- <div class="field-label">- <div class="field-title"- x-text="$store.emailConfig.incomingLabel(handler)"></div>- <div class="field-description"- x-text="$store.emailConfig.incomingDescription(handler)"></div>- </div>- <div class="field-control">- <input type="text" x-model="handler.imap_server"- :placeholder="$store.emailConfig.incomingPlaceholder(handler)" />- </div>+ <div class="field">+ <div class="field-label">+ <div class="field-title">Password</div>+ <div class="field-description">An app password is best. Many mail providers+ block regular account passwords.</div>+ </div>+ <div class="field-control">+ <input type="password" x-model="handler.password" /></div></div>- </template>- <template x-if="$store.emailConfig.showManualServers(handler)">- <div class="email-grid">- <div class="field">- <div class="field-label">- <div class="field-title">Incoming mail server</div>- <div class="field-description">The IMAP server for this inbox.</div>- </div>- <div class="field-control">- <input type="text" x-model="handler.imap_server"- placeholder="imap.your-provider.com" />+ <template x-if="$store.emailConfig.showExchangeServer(handler)">+ <div>+ <div class="field">+ <div class="field-label">+ <div class="field-title"+ x-text="$store.emailConfig.incomingLabel(handler)"></div>+ <div class="field-description"+ x-text="$store.emailConfig.incomingDescription(handler)"></div>+ </div>+ <div class="field-control">+ <input type="text" x-model="handler.imap_server"+ :placeholder="$store.emailConfig.incomingPlaceholder(handler)" />+ </div></div></div>+ </template>- <div class="field">- <div class="field-label">- <div class="field-title">Incoming port</div>- <div class="field-description">993 is the usual SSL port.</div>- </div>- <div class="field-control">- <input type="number" x-model.number="handler.imap_port"- placeholder="993" />+ <template x-if="$store.emailConfig.showManualServers(handler)">+ <div class="email-grid">+ <div class="field">+ <div class="field-label">+ <div class="field-title">Incoming mail server</div>+ <div class="field-description">The IMAP server for this inbox.</div>+ </div>+ <div class="field-control">+ <input type="text" x-model="handler.imap_server"+ placeholder="imap.your-provider.com" />+ </div></div>- </div>- <div class="field">- <div class="field-label">- <div class="field-title">Outgoing mail server</div>- <div class="field-description">The SMTP server used for replies.</div>- </div>- <div class="field-control">- <input type="text" x-model="handler.smtp_server"- placeholder="smtp.your-provider.com" />+ <div class="field">+ <div class="field-label">+ <div class="field-title">Incoming port</div>+ <div class="field-description">993 is the usual SSL port.</div>+ </div>+ <div class="field-control">+ <input type="number" x-model.number="handler.imap_port"+ placeholder="993" />+ </div></div>- </div>- <div class="field">- <div class="field-label">- <div class="field-title">Outgoing port</div>- <div class="field-description">587 is the usual TLS port.</div>+ <div class="field">+ <div class="field-label">+ <div class="field-title">Outgoing mail server</div>+ <div class="field-description">The SMTP server used for replies.+ </div>+ </div>+ <div class="field-control">+ <input type="text" x-model="handler.smtp_server"+ placeholder="smtp.your-provider.com" />+ </div></div>- <div class="field-control">- <input type="number" x-model.number="handler.smtp_port"- placeholder="587" />++ <div class="field">+ <div class="field-label">+ <div class="field-title">Outgoing port</div>+ <div class="field-description">587 is the usual TLS port.</div>+ </div>+ <div class="field-control">+ <input type="number" x-model.number="handler.smtp_port"+ placeholder="587" />+ </div></div></div>- </div>- </template>-- <template- x-if="!$store.emailConfig.showManualServers(handler) && !$store.emailConfig.showExchangeServer(handler) && $store.emailConfig.providerValue(handler)">- <div class="email-note">- Server settings are filled in for <span- x-text="$store.emailConfig.providerLabel($store.emailConfig.providerValue(handler))"></span>.- You can change them any time in Advanced.- </div>- </template>+ </template>- <div class="email-missing" x-show="$store.emailConfig.missingBits(handler).length > 0">- Still needed:- <span x-text="$store.emailConfig.missingBits(handler).join(', ')"></span>- </div>+ <template+ x-if="!$store.emailConfig.showManualServers(handler) && !$store.emailConfig.showExchangeServer(handler) && $store.emailConfig.providerValue(handler)">+ <div class="email-note">+ Server settings are filled in for <span+ x-text="$store.emailConfig.providerLabel($store.emailConfig.providerValue(handler))"></span>.+ You can change them any time in Advanced.+ </div>+ </template>- <div class="field">- <div class="field-label">- <div class="field-title">Routing instructions</div>- <div class="field-description">Extra guidance for how incoming email should be- routed into chats.</div>- </div>- <div class="field-control">- <textarea x-model="handler.dispatcher_instructions" rows="3"- placeholder="Always start a new chat for invoices or billing questions."></textarea>+ <div class="email-missing"+ x-show="$store.emailConfig.missingBits(handler).length > 0">+ Still needed:+ <span x-text="$store.emailConfig.missingBits(handler).join(', ')"></span></div>- </div>- <div class="field">- <div class="field-label">- <div class="field-title">Reply instructions</div>- <div class="field-description">Extra guidance for the agent when it replies by- email.</div>+ <div class="field">+ <div class="field-label">+ <div class="field-title">Routing instructions</div>+ <div class="field-description">Extra guidance for how incoming email should be+ routed into chats.</div>+ </div>+ <div class="field-control">+ <textarea x-model="handler.dispatcher_instructions" rows="3"+ placeholder="Always start a new chat for invoices or billing questions."></textarea>+ </div></div>- <div class="field-control">- <textarea x-model="handler.agent_instructions" rows="3"- placeholder="Reply in a calm, concise tone."></textarea>++ <div class="field">+ <div class="field-label">+ <div class="field-title">Reply instructions</div>+ <div class="field-description">Extra guidance for the agent when it replies by+ email.</div>+ </div>+ <div class="field-control">+ <textarea x-model="handler.agent_instructions" rows="3"+ placeholder="Reply in a calm, concise tone."></textarea>+ </div></div>- </div>- <div class="email-test-panel">- <div class="email-test-copy">- <div class="email-test-title">Check the connection</div>- <div class="email-test-description"- x-text="$store.emailConfig.testIntro(handler)"></div>+ <div class="email-test-panel">+ <div class="email-test-copy">+ <div class="email-test-title">Check the connection</div>+ <div class="email-test-description"+ x-text="$store.emailConfig.testIntro(handler)"></div>+ </div>+ <button class="btn btn-field" @click.stop="$store.emailConfig.testConnection(idx)"+ :disabled="$store.emailConfig.testing === idx || !$store.emailConfig.canTest(handler)">+ <span x-text="$store.emailConfig.testButtonLabel(handler, idx)"></span>+ </button></div>- <button class="btn btn-field" @click.stop="$store.emailConfig.testConnection(idx)"- :disabled="$store.emailConfig.testing === idx || !$store.emailConfig.canTest(handler)">- <span x-text="$store.emailConfig.testButtonLabel(handler, idx)"></span>- </button>- </div>- <template- x-if="$store.emailConfig.testResults && $store.emailConfig.testResultsFor === idx">- <div class="email-results"- :class="{ 'is-error': !$store.emailConfig.testResults.success }">- <template x-for="result in $store.emailConfig.testResults.results"- :key="result.test + result.message">- <div class="email-result-row">- <span class="email-result-icon" x-text="result.ok ? '✓' : '✗'"></span>- <div class="email-result-copy">- <div class="email-result-title"- x-text="$store.emailConfig.resultTitle(result)"></div>- <div class="email-result-message"- x-text="$store.emailConfig.resultMessage(result)"></div>+ <template+ x-if="$store.emailConfig.testResults && $store.emailConfig.testResultsFor === idx">+ <div class="email-results"+ :class="{ 'is-error': !$store.emailConfig.testResults.success }">+ <template x-for="result in $store.emailConfig.testResults.results"+ :key="result.test + result.message">+ <div class="email-result-row">+ <span class="email-result-icon" x-text="result.ok ? '✓' : '✗'"></span>+ <div class="email-result-copy">+ <div class="email-result-title"+ x-text="$store.emailConfig.resultTitle(result)"></div>+ <div class="email-result-message"+ x-text="$store.emailConfig.resultMessage(result)"></div>+ </div></div>- </div>- </template>- </div>- </template>+ </template>+ </div>+ </template>+ </div>- <details class="email-advanced">+ <details class="email-advanced" x-show="$store.emailConfig.hasProvider(handler)"><summary><span>Advanced</span><span class="material-symbols-outlined email-advanced-chevron"@@ -590,6 +624,173 @@transform: rotate(180deg);}+ .email-provider-panel {+ margin: 1rem 0;+ padding: 0.95rem;+ border: 1px solid color-mix(in srgb, var(--color-border) 86%, white 14%);+ border-radius: 0.5rem;+ background: color-mix(in srgb, var(--color-background) 92%, white 8%);+ }++ .email-provider-panel.has-provider {+ background: color-mix(in srgb, var(--color-background) 88%, white 12%);+ }++ .email-provider-topline {+ display: flex;+ align-items: flex-start;+ justify-content: space-between;+ gap: 1rem;+ }++ .email-provider-copy {+ min-width: 0;+ }++ .email-provider-title {+ font-size: 1rem;+ font-weight: 800;+ line-height: 1.35;+ }++ .email-provider-description {+ margin-top: 0.35rem;+ color: var(--color-text-secondary);+ line-height: 1.5;+ }++ .email-change-provider {+ flex: 0 0 auto;+ }++ .email-provider-grid {+ display: grid;+ grid-template-columns: repeat(3, minmax(0, 1fr));+ gap: 0.7rem;+ margin-top: 0.95rem;+ }++ .email-provider-option {+ appearance: none;+ width: 100%;+ min-height: 5.5rem;+ border: 1px solid color-mix(in srgb, var(--color-border) 84%, white 16%);+ border-radius: 0.5rem;+ padding: 0.8rem;+ background: color-mix(in srgb, var(--color-background) 96%, white 4%);+ color: var(--color-text);+ display: grid;+ grid-template-columns: auto minmax(0, 1fr);+ grid-template-rows: auto auto;+ align-items: center;+ column-gap: 0.75rem;+ row-gap: 0.15rem;+ font: inherit;+ text-align: left;+ cursor: pointer;+ transition: border-color 0.16s ease, background 0.16s ease, transform 0.16s ease;+ }++ .email-provider-option:hover,+ .email-provider-option:focus-visible {+ border-color: color-mix(in srgb, var(--color-highlight) 58%, var(--color-border) 42%);+ background: color-mix(in srgb, var(--color-background) 88%, white 12%);+ transform: translateY(-1px);+ outline: none;+ }++ .email-provider-option.is-selected {+ border-color: color-mix(in srgb, var(--color-highlight) 78%, white 22%);+ background: color-mix(in srgb, var(--color-highlight) 10%, var(--color-background) 90%);+ }++ .email-provider-logo {+ grid-row: 1 / span 2;+ width: 2.7rem;+ height: 2.7rem;+ border-radius: 0.5rem;+ display: inline-flex;+ align-items: center;+ justify-content: center;+ overflow: hidden;+ font-size: 1.1rem;+ font-weight: 900;+ letter-spacing: 0;+ }++ .email-provider-logo .material-symbols-outlined {+ font-size: 1.45rem;+ }++ .logo-gmail .email-provider-logo {+ background: #ffffff;+ color: #ea4335;+ border: 1px solid rgba(234, 67, 53, 0.45);+ }++ .logo-icloud .email-provider-logo {+ background: linear-gradient(135deg, #e0f2fe, #ffffff);+ color: #2563eb;+ }++ .logo-yahoo .email-provider-logo {+ background: #6001d2;+ color: #ffffff;+ }++ .logo-exchange .email-provider-logo {+ background: #0078d4;+ color: #ffffff;+ }++ .logo-custom-imap .email-provider-logo {+ background: color-mix(in srgb, var(--color-background) 72%, white 28%);+ color: var(--color-text-secondary);+ }++ .email-microsoft-mark {+ width: 1.55rem;+ height: 1.55rem;+ display: grid;+ grid-template-columns: repeat(2, minmax(0, 1fr));+ gap: 0.16rem;+ }++ .email-microsoft-mark span:nth-child(1) {+ background: #f25022;+ }++ .email-microsoft-mark span:nth-child(2) {+ background: #7fba00;+ }++ .email-microsoft-mark span:nth-child(3) {+ background: #00a4ef;+ }++ .email-microsoft-mark span:nth-child(4) {+ background: #ffb900;+ }++ .email-provider-name {+ min-width: 0;+ font-weight: 800;+ line-height: 1.25;+ overflow-wrap: anywhere;+ }++ .email-provider-hint {+ min-width: 0;+ color: var(--color-text-secondary);+ font-size: var(--font-size-small);+ line-height: 1.35;+ overflow-wrap: anywhere;+ }++ .email-post-provider {+ margin-top: 0.3rem;+ }+.email-intro-copy {margin: 1rem 0;padding: 0.85rem 0.95rem;@@ -764,6 +965,10 @@@media (max-width: 900px) {+ .email-provider-grid {+ grid-template-columns: repeat(2, minmax(0, 1fr));+ }+.email-guide-body,.email-grid {grid-template-columns: minmax(0, 1fr);@@ -783,6 +988,20 @@width: 100%;}+ .email-provider-topline {+ flex-direction: column;+ align-items: stretch;+ }++ .email-provider-grid,+ .email-grid {+ grid-template-columns: minmax(0, 1fr);+ }++ .email-change-provider {+ align-self: flex-start;+ }+.email-status-pill {min-width: 0;}diff --git a/plugins/_email_integration/webui/email-config-store.js b/plugins/_email_integration/webui/email-config-store.jsindex aa9300d2b..33b0884e6 100644--- a/plugins/_email_integration/webui/email-config-store.js+++ b/plugins/_email_integration/webui/email-config-store.js@@ -62,6 +62,51 @@ const PRESETS = {},};+const PROVIDER_OPTIONS = [+ {+ value: "gmail",+ label: "Gmail",+ hint: "Google app password",+ logo: "gmail",+ logoText: "M",+ },+ {+ value: "icloud",+ label: "iCloud Mail",+ hint: "Apple app-specific password",+ logo: "icloud",+ logoText: "cloud",+ },+ {+ value: "microsoft365",+ label: "Outlook / Microsoft 365",+ hint: "Microsoft mailbox preset",+ logo: "microsoft365",+ logoText: "",+ },+ {+ value: "yahoo",+ label: "Yahoo Mail",+ hint: "Yahoo app password",+ logo: "yahoo",+ logoText: "Y!",+ },+ {+ value: "exchange",+ label: "Exchange",+ hint: "Organization Exchange server",+ logo: "exchange",+ logoText: "X",+ },+ {+ value: "custom-imap",+ label: "Custom IMAP",+ hint: "Manual server settings",+ logo: "custom-imap",+ logoText: "dns",+ },+];+function ensureConfig(config) {if (!config || typeof config !== "object") return;if (!Array.isArray(config.handlers)) config.handlers = [];@@ -74,18 +119,25 @@ export const store = createStore("emailConfig", {testing: null,testResults: null,testResultsFor: null,+ providerPickerOpen: null,guideOpen: false,didInit: false,projects: [],modelPresets: [],presets: PRESETS,+ get providerOptions() {+ return PROVIDER_OPTIONS;+ },+get handlers() {ensureConfig(this.config);return Array.isArray(this.config?.handlers) ? this.config.handlers : [];},async init(config, context = null) {+ if (!config || typeof config !== "object") return;+this.config = config || null;this.context = context;this.didInit = false;@@ -94,8 +146,12 @@ export const store = createStore("emailConfig", {this.testing = null;this.testResults = null;this.testResultsFor = null;+ this.providerPickerOpen = null;this.guideOpen = this.handlers.length === 0 && window.innerWidth > 720;if (this.handlers.length === 0) this._startInitialHandlerFlow();+ if (this.editing !== null && !this.hasProvider(this.handlers[this.editing])) {+ this.providerPickerOpen = this.editing;+ }this.didInit = true;const [projectsResult, presetsResult] = await Promise.allSettled([@@ -116,6 +172,7 @@ export const store = createStore("emailConfig", {this.testing = null;this.testResults = null;this.testResultsFor = null;+ this.providerPickerOpen = null;this.guideOpen = false;this.didInit = false;},@@ -124,6 +181,7 @@ export const store = createStore("emailConfig", {return {name: "",enabled: false,+ provider: "",account_type: "imap",imap_server: "",imap_port: 993,@@ -148,6 +206,7 @@ export const store = createStore("emailConfig", {ensureConfig(this.config);this.config.handlers.push(this.newHandler());this.editing = this.config.handlers.length - 1;+ this.providerPickerOpen = this.editing;this.testResults = null;this.testResultsFor = null;},@@ -156,6 +215,8 @@ export const store = createStore("emailConfig", {this.handlers.splice(idx, 1);if (this.editing === idx) this.editing = null;if (this.editing !== null && this.editing > idx) this.editing -= 1;+ if (this.providerPickerOpen === idx) this.providerPickerOpen = null;+ if (this.providerPickerOpen !== null && this.providerPickerOpen > idx) this.providerPickerOpen -= 1;if (this.testResultsFor === idx) {this.testResults = null;this.testResultsFor = null;@@ -164,6 +225,11 @@ export const store = createStore("emailConfig", {toggleEditing(idx) {this.editing = this.editing === idx ? null : idx;+ if (this.editing === null) {+ this.providerPickerOpen = null;+ } else if (!this.hasProvider(this.handlers[idx])) {+ this.providerPickerOpen = idx;+ }if (this.testResultsFor !== idx) {this.testResults = null;this.testResultsFor = null;@@ -171,6 +237,10 @@ export const store = createStore("emailConfig", {},providerValue(handler) {+ if (!handler || typeof handler !== "object") return "";+ const explicitProvider = String(handler.provider || "").trim();+ if (explicitProvider && this.presets[explicitProvider]) return explicitProvider;+const incoming = String(handler.imap_server || "").trim().toLowerCase();const outgoing = String(handler.smtp_server || "").trim().toLowerCase();const accountType = handler.account_type || "imap";@@ -184,16 +254,37 @@ export const store = createStore("emailConfig", {return "custom-imap";},+ hasProvider(handler) {+ return Boolean(this.providerValue(handler));+ },++ showProviderChoices(handler, idx) {+ return !this.hasProvider(handler) || this.providerPickerOpen === idx;+ },++ changeProvider(idx) {+ this.providerPickerOpen = this.providerPickerOpen === idx ? null : idx;+ },+providerLabel(value) {return this.presets[value]?.label || "Custom IMAP";},+ selectProvider(handler, value, idx = null) {+ this.applyProvider(handler, value);+ this.providerPickerOpen = null;+ this.testResults = null;+ this.testResultsFor = null;+ if (idx !== null) this.editing = idx;+ },+applyProvider(handler, value) {const preset = this.presets[value];if (!preset) return;const previous = this.providerValue(handler);handler.account_type = preset.account_type;+ handler.provider = value;if (value === "custom-imap") {if (previous !== "custom-imap") {diff --git a/plugins/_onboarding/webui/onboarding-store.js b/plugins/_onboarding/webui/onboarding-store.jsindex aff664e64..8864ffd9e 100644--- a/plugins/_onboarding/webui/onboarding-store.js+++ b/plugins/_onboarding/webui/onboarding-store.js@@ -8,6 +8,11 @@ export const store = createStore("onboarding", {step: 1,config: null,loading: true,+ steps: [+ { step: 1, label: "Main Model" },+ { step: 2, label: "Utility Model" },+ { step: 3, label: "Ready" },+ ],async init() {this.step = 1;@@ -62,6 +67,19 @@ export const store = createStore("onboarding", {}},+ nextButtonLabel() {+ if (this.step === 1) return "Use Main Model";+ if (this.step === 2) return "Use Utility Model";+ return "Next";+ },++ providerLabel(modelKey) {+ const provider = this.config?.[modelKey]?.provider || "";+ const providers = modelConfigStore.getProviders(modelKey) || [];+ const match = providers.find((item) => item.value === provider);+ return match?.label || provider || "Provider";+ },+async finish() {this.loading = true;try {@@ -98,4 +116,4 @@ export const store = createStore("onboarding", {const { store: pluginSettingsStore } = await import("/components/plugins/plugin-settings-store.js");await pluginSettingsStore.openConfig("_model_config");}-});\ No newline at end of file+});diff --git a/plugins/_onboarding/webui/onboarding.html b/plugins/_onboarding/webui/onboarding.htmlindex a3ea9f5ea..8b9e894c5 100644--- a/plugins/_onboarding/webui/onboarding.html+++ b/plugins/_onboarding/webui/onboarding.html@@ -1,13 +1,22 @@-<html>+<html class="onboarding-modal"><head><title>Welcome to Agent Zero</title><script type="module">import { store } from "/plugins/_onboarding/webui/onboarding-store.js";</script><style>+ .modal-inner.onboarding-modal {+ width: min(92vw, 980px);+ }+ .modal-inner.onboarding-modal .modal-scroll {+ padding: 0;+ }+ .modal-inner.onboarding-modal .modal-bd.onboarding-body {+ padding: 24px 32px 28px;+ }.onboarding-logo {text-align: center;- margin-bottom: 24px;+ margin-bottom: 18px;}.onboarding-logo img {width: 200px;@@ -16,17 +25,78 @@}.onboarding-welcome-text {text-align: center;- margin: var(--spacing-md) 0 var(--spacing-lg) 0;+ max-width: 78ch;+ margin: var(--spacing-md) auto var(--spacing-lg);color: var(--text-2);- font-size: 1.1rem;+ font-size: 1.02rem;line-height: 1.5;}.onboarding-welcome-title {color: var(--text-1);- font-size: 1.5rem;- font-weight: 600;+ font-size: 1.42rem;+ font-weight: 800;margin-bottom: 12px;}+ .onboarding-progress {+ display: grid;+ grid-template-columns: repeat(3, minmax(0, 1fr));+ gap: 6px;+ margin: 0 0 24px;+ padding: 7px;+ border: 1px solid color-mix(in srgb, var(--color-border) 64%, transparent);+ border-radius: 8px;+ background: color-mix(in srgb, var(--color-panel) 42%, transparent);+ }+ .onboarding-progress-step {+ display: flex;+ align-items: center;+ gap: 8px;+ min-width: 0;+ min-height: 36px;+ padding: 0 10px;+ border: 1px solid transparent;+ border-radius: 7px;+ color: var(--color-text);+ opacity: 0.64;+ font-size: 0.84rem;+ font-weight: 700;+ }+ .onboarding-progress-step.active {+ opacity: 1;+ border-color: color-mix(in srgb, var(--color-primary) 32%, var(--color-border));+ background: color-mix(in srgb, var(--color-background-hover) 58%, transparent);+ }+ .onboarding-progress-step.done {+ opacity: 0.88;+ }+ .onboarding-progress-dot {+ display: grid;+ place-items: center;+ width: 20px;+ height: 20px;+ border-radius: 999px;+ background: color-mix(in srgb, var(--color-border) 70%, transparent);+ color: var(--color-background);+ font-size: 0.72rem;+ font-weight: 900;+ flex: 0 0 auto;+ }+ .onboarding-progress-step.active .onboarding-progress-dot {+ background: var(--color-primary);+ }+ .onboarding-progress-step.done .onboarding-progress-dot {+ background: #63c98b;+ }+ .onboarding-progress-check {+ font-size: 14px;+ line-height: 1;+ }+ .onboarding-progress-label {+ min-width: 0;+ overflow: hidden;+ text-overflow: ellipsis;+ white-space: nowrap;+ }.onboarding-success {text-align: center;padding: var(--spacing-md) 0;@@ -61,12 +131,16 @@}/* Scoped overrides to make the fields look nice here */.onboarding-body .model-section {- background: var(--surface-2);+ padding: 16px;+ background: color-mix(in srgb, var(--color-panel) 58%, transparent);border-radius: 8px;- border: 1px solid var(--surface-3);+ border: 1px solid color-mix(in srgb, var(--color-border) 64%, transparent);}.onboarding-body .section-title { margin-bottom: 8px; }.onboarding-body .section-description { margin-bottom: 24px; }+ .onboarding-body .model-section .field:last-child {+ margin-bottom: 0;+ }.onboarding-body .loading-container { height: 200px; }.onboarding-body .input-with-icon { padding-right: 32px; }.onboarding-body .relative-container { position: relative; }@@ -160,6 +234,17 @@.onboarding-body .model-search-item.disabled:hover {background: transparent;}+ @media (max-width: 720px) {+ .modal-inner.onboarding-modal .modal-bd.onboarding-body {+ padding: 18px 16px 22px;+ }+ .onboarding-progress {+ grid-template-columns: 1fr;+ }+ .onboarding-welcome-text {+ font-size: 0.96rem;+ }+ }</style></head>@@ -181,22 +266,36 @@<template x-if="!$store.onboarding.loading && $store.onboarding.config"><div>+ <nav class="onboarding-progress" aria-label="Onboarding progress">+ <template x-for="item in $store.onboarding.steps" :key="item.step">+ <div class="onboarding-progress-step"+ :class="{ active: $store.onboarding.step === item.step, done: $store.onboarding.step > item.step }"+ :aria-current="$store.onboarding.step === item.step ? 'step' : null">+ <span class="onboarding-progress-dot">+ <span x-show="$store.onboarding.step <= item.step" x-text="item.step"></span>+ <span class="material-symbols-outlined onboarding-progress-check" x-show="$store.onboarding.step > item.step">check</span>+ </span>+ <span class="onboarding-progress-label" x-text="item.label"></span>+ </div>+ </template>+ </nav><!-- Step 1: Main Model --><div x-show="$store.onboarding.step === 1"><div class="onboarding-welcome-text"><div class="onboarding-welcome-title">Welcome to Agent Zero</div>- Let's get your models configured. The <b>Main Model</b> handles chat, tool calls, skills, and browser automation. We recommend a capable model like Claude Sonnet 4.6, GPT-5.4, Kimi 2.5, or similar.+ First, choose the model Agent Zero will think with. The <b>Main Model</b> handles conversation, tool calls, skills, and browser work.</div><div class="model-section"><div class="section-title" x-text="$store.modelConfig.MODEL_SECTIONS[0].title"></div>- <div class="section-description" x-text="$store.modelConfig.MODEL_SECTIONS[0].desc"></div>+ <div class="section-description">Choose a capable general model for conversation, reasoning, tools, skills, and browser automation.</div><!-- Provider --><div class="field"><div class="field-label"><div class="field-title">Provider</div>+ <div class="field-description">Where Agent Zero will send Main Model requests.</div></div><div class="field-control"><select x-model="$store.onboarding.config.chat_model.provider"@@ -212,7 +311,7 @@<div class="field"><div class="field-label"><div class="field-title">Model name</div>- <div class="field-description">Model identifier. Click the search icon to browse available models.</div>+ <div class="field-description">Use the suggested model or search for another capable general-purpose model.</div></div><div class="field-control relative-container"x-data="{ results: [], open: false, searching: false,@@ -243,7 +342,8 @@<!-- API Key --><div class="field"><div class="field-label">- <div class="field-title">API key</div>+ <div class="field-title" x-text="`${$store.onboarding.providerLabel('chat_model')} API key`"></div>+ <div class="field-description">Saved keys stay hidden. Paste a new key only when you need to add or replace one.</div></div><div class="field-control relative-container" x-data="{ showKey: false }"><input :type="showKey ? 'text' : 'password'"@@ -269,18 +369,19 @@<!-- Step 2: Utility Model --><div x-show="$store.onboarding.step === 2"><div class="onboarding-welcome-text">- <div class="onboarding-welcome-title">Almost there!</div>- The <b>Utility Model</b> handles background tasks like summarization and memory updates. A fast, cheap model like GPT-5.4-mini, Gemini 3.1 Flash Lite, or similar works best here.+ <div class="onboarding-welcome-title">Choose your Utility Model</div>+ Agent Zero uses the <b>Utility Model</b> for quiet work: summaries, memory, and preparation. Pick something fast, reliable, and cost-conscious.</div><div class="model-section"><div class="section-title" x-text="$store.modelConfig.MODEL_SECTIONS[1].title"></div>- <div class="section-description" x-text="$store.modelConfig.MODEL_SECTIONS[1].desc"></div>+ <div class="section-description">Choose a fast, reliable model for summaries, memory, and prompt preparation.</div><!-- Provider --><div class="field"><div class="field-label"><div class="field-title">Provider</div>+ <div class="field-description">Use the same provider as your Main Model, or choose a faster low-cost option.</div></div><div class="field-control"><select x-model="$store.onboarding.config.utility_model.provider"@@ -296,7 +397,7 @@<div class="field"><div class="field-label"><div class="field-title">Model name</div>- <div class="field-description">Model identifier. Click the search icon to browse available models.</div>+ <div class="field-description">The suggested model is tuned for speed and cost. Search if your provider uses another name.</div></div><div class="field-control relative-container"x-data="{ results: [], open: false, searching: false,@@ -327,7 +428,8 @@<!-- API Key --><div class="field"><div class="field-label">- <div class="field-title">API key</div>+ <div class="field-title" x-text="`${$store.onboarding.providerLabel('utility_model')} API key`"></div>+ <div class="field-description">Saved keys stay hidden. Paste a new key only when you need to add or replace one.</div></div><div class="field-control relative-container" x-data="{ showKey: false }"><input :type="showKey ? 'text' : 'password'"@@ -354,8 +456,9 @@<div x-show="$store.onboarding.step === 3" class="onboarding-success"><div class="material-symbols-outlined onboarding-success-icon">check_circle</div><div class="onboarding-welcome-text onboarding-success-text">- Your models are configured. You can change these anytime in Settings.<br>- While you're here, why not check out some integrations to extend what Agent Zero can do?+ <div class="onboarding-welcome-title">Agent Zero is ready</div>+ Your models are configured. You can change them anytime in Settings.<br>+ You can also connect integrations now and give Agent Zero more places to work.</div><x-extension id="onboarding-success-end"></x-extension></div>@@ -381,7 +484,8 @@</button><button class="btn btn-ok" x-show="$store.onboarding.step < 3" @click="$store.onboarding.next()" :disabled="$store.onboarding.loading">- Next <span class="material-symbols-outlined onboarding-icon-right">arrow_forward</span>+ <span x-text="$store.onboarding.nextButtonLabel()"></span>+ <span class="material-symbols-outlined onboarding-icon-right">arrow_forward</span></button><button class="btn btn-ok" x-show="$store.onboarding.step === 3" @click="$store.onboarding.finish()" :disabled="$store.onboarding.loading">@@ -394,4 +498,4 @@</template></div></body>-</html>\ No newline at end of file+</html>