A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
// Settings → Connectors: connected rows, a catalog with search and categories,
// an Add menu, and the mailbox. One row component draws the mark, name, status
// and the expanding panels (browser sign-in, device code, key/token, client).
import { createElement as h, useEffect, useRef, useState } from 'react'
import { MaskedInput } from './secret-card.js'
import { Switch, SwitchRow } from './bot-settings.js'
import { Segmented, useMorph } from './motion.js'
import { openPage, reserveWindow } from './open-window.js'
import { contentText, currentPart } from './text.js'
import { useDockHold } from './card-hold.js'
import { heldCardKey } from './sources.js'
import { CellEmpty } from './cell-empty.js'
import { hostText, t } from './i18n.js'
import { CheckIcon, ChevronDownIcon } from './icons.js'
import { ViewCard } from './widget-cell.js'
export { GitHubMark } from './connector-marks.js'
import { MARKS } from './connector-marks.js'
const TOKEN_URL = 'https://github.com/settings/personal-access-tokens/new'
// Rows show the service mark, or a generated monogram for custom entries.
export function ConnectorMark({ connector }) {
const Mark = MARKS[connector.id]
if (Mark) return h(Mark)
let hash = 0
for (const ch of String(connector.id)) hash = (hash * 31 + ch.charCodeAt(0)) >>> 0
return h('span', { className: 'bt-connector-mono', style: { '--bt-hue': hash % 360 }, 'aria-hidden': true }, (connector.name ?? '?').slice(0, 1).toUpperCase())
}
function statusText(connector) {
if (connector.state === 'connecting') return connector.pending ? t('Waiting for sign-in…') : t('Connecting…')
if (connector.state === 'needs-sign-in') return t('Sign in again')
if (connector.state === 'needs-client') return t('This service needs an app client ID')
if (connector.state === 'error') return t('Could not connect: {error}', { error: connector.error ?? '' })
if (connector.state === 'ready') {
const who = connector.account ? t('Connected as {account}', { account: connector.account }) : t('Connected')
return connector.tools > 0 ? `${who} · ${t('{count} tools', { count: connector.tools })}` : who
}
return connector.about ? t(connector.about) : ''
}
// Sign-in pages open on their own when Connect is clicked; these panels say what
// is happening and keep a way back if the page was closed or never came back.
function BrowserPanel({ connector, actions, run }) {
const [pasting, setPasting] = useState(false)
const [input, setInput] = useState('')
return h('div', { className: 'bt-connector-form' },
h('div', { className: 'bt-connector-form-row' },
h('span', { className: 'bt-connector-wait' }, t('Finish signing in in your browser.')),
h('button', { type: 'button', className: 'bt-connector-link', onClick: () => openPage(connector.pending.url) }, t('Open again')),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: () => void run(actions.connectorCancel(connector.id)) }, t('Cancel'))),
pasting
? h('div', { className: 'bt-connector-form-row' },
h('input', { className: 'bt-input', 'aria-label': t('Paste the address you land on'), placeholder: t('Paste the address you land on'), value: input, spellCheck: false, autoComplete: 'off', autoFocus: true, onChange: e => setInput(e.target.value) }),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: input.trim() === '', onClick: () => void run(actions.connectorSignInCode(connector.id, input.trim())) }, t('Finish sign-in')))
: h('button', { type: 'button', className: 'bt-connector-link bt-connector-aside', onClick: () => setPasting(true) }, t('Did not come back here?')))
}
function DevicePanel({ connector, actions, run, onUseToken }) {
const { userCode, verificationUri } = connector.pending
const [copied, setCopied] = useState(false)
const copy = () => { void navigator.clipboard?.writeText(userCode).then(() => { setCopied(true); setTimeout(() => setCopied(false), 1600) }) }
return h('div', { className: 'bt-connector-form' },
h('div', { className: 'bt-connector-device' },
h('code', { className: 'bt-connector-code' }, userCode),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: copy }, copied ? t('Copied') : t('Copy'))),
h('div', { className: 'bt-connector-form-row' },
h('span', { className: 'bt-connector-wait' }, t('Paste the code on {host} and authorize.', { host: verificationUri.replace(/^https?:\/\//, '') })),
h('button', { type: 'button', className: 'bt-connector-link', onClick: () => openPage(verificationUri) }, t('Open again')),
connector.auth?.token === true && onUseToken ? h('button', { type: 'button', className: 'bt-connector-link', onClick: () => void run(actions.connectorCancel(connector.id), onUseToken) }, t('Use a token instead')) : null,
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: () => void run(actions.connectorCancel(connector.id)) }, t('Cancel'))))
}
function ClientPanel({ connector, actions, run }) {
const [clientId, setClientId] = useState('')
const [clientSecret, setClientSecret] = useState('')
return h('div', { className: 'bt-connector-form' },
h('input', { className: 'bt-input', 'aria-label': t('Client ID'), placeholder: t('Client ID'), value: clientId, spellCheck: false, autoComplete: 'off', onChange: e => setClientId(e.target.value) }),
h('label', { className: 'bt-q-field bt-secret-field' }, h(MaskedInput, { value: clientSecret, onChange: setClientSecret, label: t('Client secret (optional)') })),
h('div', { className: 'bt-connector-form-row' },
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: () => void run(actions.connectorCancel(connector.id)) }, t('Cancel')),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: clientId.trim() === '', onClick: () => void run(actions.connectorClient(connector.id, clientId.trim(), clientSecret.trim() || undefined)) }, t('Continue'))))
}
function TokenPanel({ connector, actions, run, onDone }) {
const [token, setToken] = useState('')
const isKey = connector.auth?.kind === 'key'
const connect = () => {
if (token.trim() === '') return
void run(isKey ? actions.connectorConnect(connector.id, { key: token.trim() }) : actions.connectorConnect(connector.id, { token: token.trim() }), () => { setToken(''); onDone?.() })
}
return h('div', { className: 'bt-connector-form' },
h('label', { className: 'bt-q-field bt-secret-field' }, h(MaskedInput, { value: token, onChange: setToken, onEnter: connect, label: isKey ? t('{name} key', { name: connector.name }) : t('{name} token', { name: connector.name }), autoFocus: true })),
h('div', { className: 'bt-connector-form-row' },
(connector.id === 'github' ? h('a', { className: 'bt-connector-link', href: TOKEN_URL, target: '_blank', rel: 'noopener noreferrer' }, t('Create a token on GitHub'))
: connector.auth?.keyUrl ? h('a', { className: 'bt-connector-link', href: connector.auth.keyUrl, target: '_blank', rel: 'noopener noreferrer' }, t('Get a key')) : h('span', { className: 'bt-connector-wait' })),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: onDone }, t('Cancel')),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: token.trim() === '', onClick: connect }, t('Connect'))))
}
// Opens the sign-in page the host answers with: the browser page for OAuth, or the
// device page with the code already on the clipboard.
export const openSignIn = (win, id, view) => {
const pending = view?.connectors?.find(entry => entry.id === id)?.pending
if (pending?.kind === 'browser') return void win.go(pending.url)
if (pending?.kind === 'device') {
void navigator.clipboard?.writeText(pending.userCode).catch(() => {})
return void win.go(pending.verificationUri)
}
win.close()
}
export function ConnectorRow({ connector, actions }) {
const [form, setForm] = useState(null)
const [busy, setBusy] = useState(false)
const [error, setError] = useState(null)
const run = (task, after, failed) => {
setBusy(true); setError(null)
return Promise.resolve(task).then(value => { after?.(value) }, (failure) => { failed?.(); setError(failure?.message ?? String(failure)) }).finally(() => setBusy(false))
}
const on = connector.state !== 'off' && connector.state !== 'needs-client'
const pending = connector.pending
const row = useRef(null)
useMorph(row, `${form}:${error !== null}:${connector.state}:${pending?.kind ?? ''}`)
const signIn = () => {
const win = reserveWindow()
void run(actions.connectorConnect(connector.id, {}), view => openSignIn(win, connector.id, view), () => win.close())
}
const connect = () => {
if (connector.auth?.kind === 'none') return void run(actions.connectorConnect(connector.id, {}))
if (connector.auth?.kind === 'key') return setForm('token')
if (connector.auth?.kind === 'oauth') return connector.auth.client?.id || !connector.auth.token ? signIn() : setForm('token')
return undefined
}
const button = (label, onClick) => h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: busy, onClick }, label)
let actionsNode = null
if (pending || form) actionsNode = null
else if (connector.state === 'needs-sign-in') actionsNode = [button(t('Sign in again'), signIn), button(t('Disconnect'), () => void run(actions.connectorDisconnect(connector.id)))]
else if (connector.state === 'error') actionsNode = [button(t('Try again'), () => void run(actions.connectorRetry(connector.id))), button(connector.custom ? t('Remove') : t('Disconnect'), () => void run(actions.connectorDisconnect(connector.id)))]
else if (on) actionsNode = button(connector.custom ? t('Remove') : t('Disconnect'), () => void run(actions.connectorDisconnect(connector.id)))
else {
actionsNode = [
connector.auth?.kind === 'oauth' && connector.auth.token === true && connector.auth.client?.id
? h('button', { key: 'token', type: 'button', className: 'bt-connector-link', disabled: busy, onClick: () => setForm('token') }, t('Use a token instead'))
: null,
h('button', { key: 'connect', type: 'button', className: 'bt-soft bt-soft-sm', disabled: busy, onClick: connect }, busy ? t('Connecting…') : t('Connect')),
]
}
return h('div', { ref: row, className: 'bt-connector', 'data-state': connector.state },
h('div', { className: 'bt-connector-head' },
h('span', { className: 'bt-connector-mark' }, h(ConnectorMark, { connector })),
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-connector-name' }, connector.name, connector.custom ? h('span', { className: 'bt-tag' }, t('Added')) : null),
h('span', { className: 'bt-connector-status' }, statusText(connector))),
actionsNode ? h('span', { className: 'bt-connector-actions' }, actionsNode) : null),
connector.readOnly !== undefined && on && connector.state === 'ready' ? h('div', { className: 'bt-connector-ro' },
h(SwitchRow, { label: t('Read-only'), on: connector.readOnly === true, onChange: checked => void run(actions.connectorSet(connector.id, { readOnly: checked })) })) : null,
pending?.kind === 'browser' ? h(BrowserPanel, { connector, actions, run }) : null,
pending?.kind === 'device' ? h(DevicePanel, { connector, actions, run, onUseToken: () => setForm('token') }) : null,
connector.state === 'needs-client' && !pending?.kind ? h(ClientPanel, { connector, actions, run }) : null,
form === 'token' ? h(TokenPanel, { connector, actions, run, onDone: () => { setForm(null); setError(null) } }) : null,
error ? h('div', { className: 'bt-connector-error', role: 'alert' }, hostText(error)) : null)
}
// Where each mail provider's authorization code or app password comes from.
const NETEASE_STEPS = [
'Sign in at {host} and open Settings → POP3/SMTP/IMAP.',
'Turn on IMAP/SMTP and send the text message it asks for.',
'Paste the 16-character code below. It is shown only once.',
]
const NETEASE_HELP = 'https://help.mail.163.com/faqDetail.do?code=d7a5dc8471cd0c0e8b4b8f4f8e49998b374173cfe9171305fa1ce630d7f67ac2a5feb28b66796d3b'
const MAIL_GUIDES = {
qq: {
host: 'mail.qq.com',
open: 'https://mail.qq.com',
help: 'https://help.mail.qq.com/detail/106/985',
label: 'Authorization code',
steps: [
'Sign in at mail.qq.com, click your avatar at the top right, and open Settings → Account and Security → Security Settings.',
'Turn on the POP3/IMAP/SMTP service, then click Generate authorization code and verify yourself.',
'Paste the 16-letter code below. Changing your QQ password cancels it.',
],
},
'163': { host: 'mail.163.com', open: 'https://mail.163.com', help: NETEASE_HELP, label: 'Authorization code', steps: NETEASE_STEPS },
'126': { host: 'mail.126.com', open: 'https://mail.126.com', help: NETEASE_HELP, label: 'Authorization code', steps: NETEASE_STEPS },
gmail: {
host: 'myaccount.google.com',
open: 'https://myaccount.google.com/apppasswords',
help: 'https://support.google.com/accounts/answer/185833',
label: 'App password',
steps: [
'Turn on 2-Step Verification for your Google Account.',
'Open App passwords, create one, and paste the 16-character password below.',
'Work and school accounts cannot use app passwords.',
],
},
icloud: {
host: 'account.apple.com',
open: 'https://account.apple.com',
help: 'https://support.apple.com/102654',
label: 'App password',
steps: [
'Your Apple Account needs two-factor authentication.',
'Sign in at account.apple.com and open Sign-In and Security → App-Specific Passwords.',
'Generate a password and paste it below.',
],
},
}
export function MailAccount({ account, actions, run }) {
const [busy, setBusy] = useState(false)
const remove = () => {
if (busy) return
setBusy(true)
void Promise.resolve(run(actions.mailAccountRemove(account.id))).finally(() => setBusy(false))
}
const markId = `mail-${account.provider}`
return h('div', { className: 'bt-connector', 'data-state': account.error ? 'error' : 'ready' },
h('div', { className: 'bt-connector-head' },
h('span', { className: 'bt-connector-mark' }, h(ConnectorMark, { connector: { id: markId, name: account.address } })),
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-connector-name' }, account.address),
h('span', { className: 'bt-connector-status' }, account.error ? hostText(account.error) : t('Connected'))),
h('span', { className: 'bt-connector-actions' },
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: busy, onClick: remove }, t('Remove')))))
}
// A Google sign-in the host started; its page opened with the click.
export function MailPending({ pending }) {
return h('div', { className: 'bt-connector', 'data-state': 'connecting' },
h('div', { className: 'bt-connector-head' },
h('span', { className: 'bt-connector-mark' }, h(ConnectorMark, { connector: { id: 'mail-gmail', name: 'Google' } })),
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-connector-name' }, pending.address ?? 'Gmail'),
h('span', { className: 'bt-connector-status' }, t('Finish signing in in your browser.'))),
h('span', { className: 'bt-connector-actions' },
h('button', { type: 'button', className: 'bt-connector-link', onClick: () => openPage(pending.url) }, t('Open again')))))
}
// The sending rules a mail card added; they only show once there is one.
export function MailRules({ mail, bots, actions, run }) {
const allowed = mail?.allowedRecipients ?? []
const direct = mail?.noDraftFor ?? []
if (allowed.length === 0 && direct.length === 0) return null
const rule = (key, name, kind, onRemove) => h('div', { key, className: 'bt-mail-rule' },
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-mail-rule-name' }, name),
h('span', { className: 'bt-connector-status' }, kind)),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: onRemove }, t('Remove')))
return h('div', { className: 'bt-connector bt-mail-rules', 'data-state': 'ready' },
h('div', { className: 'bt-mail-rules-title' }, t('Sending rules')),
allowed.map(addr => rule(`r:${addr}`, addr, t('Allow recipient'), () => void run(actions.mailRuleSet({ removeRecipient: addr })))),
direct.map(botId => rule(`b:${botId}`, (bots ?? []).find(b => b.id === botId)?.name ?? botId, t('Allow this Bot to send directly'), () => void run(actions.mailRuleSet({ botId, noDraft: false })))))
}
const PROVIDERS = [['qq', 'QQ'], ['163', '163'], ['126', '126'], ['gmail', 'Gmail'], ['icloud', 'iCloud'], ['other', 'Other']]
const guessProvider = (address) => {
const domain = address.split('@')[1]?.toLowerCase() ?? ''
if (['qq.com', 'foxmail.com'].includes(domain)) return 'qq'
if (['163.com', '126.com'].includes(domain)) return domain.slice(0, 3)
if (['gmail.com', 'googlemail.com'].includes(domain)) return 'gmail'
if (['icloud.com', 'me.com', 'mac.com'].includes(domain)) return 'icloud'
return ''
}
// The add form opens under the Mailbox catalog row. While the host verifies the
// login every field is disabled, so a second click cannot add twice; a good add
// closes the form and drops what was typed.
function MailForm({ mail, actions, onClose }) {
const [fields, setFields] = useState({ address: '', password: '', provider: '', imapHost: '', smtpHost: '' })
const [busy, setBusy] = useState(false)
const [error, setError] = useState(null)
const busyRef = useRef(false)
const set = (key, value) => setFields(current => ({ ...current, [key]: value }))
const chosen = fields.provider || guessProvider(fields.address) || 'qq'
const guide = MAIL_GUIDES[chosen]
const google = chosen === 'gmail' && mail?.google === true
const go = (task, done) => {
if (busyRef.current) return
busyRef.current = true
setBusy(true)
setError(null)
void Promise.resolve().then(task).then(done, (failure) => { setError(failure?.message ?? String(failure)) }).finally(() => { busyRef.current = false; setBusy(false) })
}
const add = () => go(() => actions.mailAccountAdd({ address: fields.address.trim(), password: fields.password, provider: chosen, imapHost: fields.imapHost.trim(), smtpHost: fields.smtpHost.trim() }), onClose)
const signInWithGoogle = () => {
const win = reserveWindow()
go(() => actions.mailAccountAdd({ address: fields.address.trim(), google: true }).catch((failure) => { win.close(); throw failure }), (view) => {
const url = view?.mail?.pending?.at(-1)?.url ?? view?.pending?.at(-1)?.url
if (url) win.go(url)
else win.close()
onClose()
})
}
const input = (key, label, extra = {}) => h('input', { className: 'bt-input', 'aria-label': label, placeholder: label, value: fields[key], autoComplete: 'off', spellCheck: false, disabled: busy, onChange: e => set(key, e.target.value), ...extra })
return h('div', { className: 'bt-connector-form bt-mail-form' },
h(Segmented, { label: t('Provider'), value: chosen, className: 'bt-mail-seg' },
PROVIDERS.map(([id, label]) => h('button', { key: id, type: 'button', 'aria-pressed': chosen === id, disabled: busy, onClick: () => set('provider', id) }, id === 'other' ? t(label) : label))),
guide ? h('div', { className: 'bt-mail-guide' },
h('ol', null, guide.steps.map(step => h('li', { key: step }, t(step, { host: guide.host })))),
h('div', { className: 'bt-mail-links' },
h('button', { type: 'button', className: 'bt-connector-link', onClick: () => openPage(guide.open) }, t('Open {host}', { host: guide.host })),
h('button', { type: 'button', className: 'bt-connector-link', onClick: () => openPage(guide.help) }, t('Official help')))) : null,
input('address', t('Email address'), { type: 'email' }),
h('label', { className: 'bt-q-field bt-secret-field' }, h(MaskedInput, { value: fields.password, onChange: value => set('password', value), onEnter: add, label: t(guide?.label ?? 'Password or app password'), disabled: busy })),
chosen === 'other' ? h('div', { className: 'bt-provider-pair' }, input('imapHost', t('IMAP host')), input('smtpHost', t('SMTP host'))) : null,
error ? h('div', { className: 'bt-mail-error', role: 'alert' }, hostText(error)) : null,
h('div', { className: 'bt-secret-row-actions' },
google ? h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: busy, onClick: signInWithGoogle }, t('Sign in with Google')) : null,
h('span', { className: 'bt-set-hint' }),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: busy, onClick: onClose }, t('Cancel')),
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: busy || !fields.address.includes('@') || fields.password === '' || (chosen === 'other' && (fields.imapHost.trim() === '' || fields.smtpHost.trim() === '')), onClick: add }, busy ? t('Verifying…') : t('Add'))))
}
// The Mailbox in the catalog: one row for every mail service, with the add form.
export function MailCatalogRow({ mail, actions }) {
const [open, setOpen] = useState(false)
const row = useRef(null)
useMorph(row, String(open))
return h('div', { ref: row, className: 'bt-connector', 'data-state': 'off' },
h('div', { className: 'bt-connector-head' },
h('span', { className: 'bt-connector-mark' }, h(ConnectorMark, { connector: { id: 'mail', name: t('Mailbox') } })),
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-connector-name' }, t('Mailbox')),
h('span', { className: 'bt-connector-status' }, t('QQ, 163, 126, Gmail, iCloud, and other IMAP mail'))),
open ? null : h('span', { className: 'bt-connector-actions' },
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: () => setOpen(true) }, (mail?.accounts?.length ?? 0) > 0 ? t('Add another') : t('Connect')))),
open ? h(MailForm, { mail, actions, onClose: () => setOpen(false) }) : null)
}
// Your own MCP servers: an address, a command, or ones found in other apps.
export function AddMenu({ actions, run }) {
const [kind, setKind] = useState(null)
const [name, setName] = useState('')
const [url, setUrl] = useState('')
const [command, setCommand] = useState('')
const [found, setFound] = useState(null)
const [picked, setPicked] = useState([])
const row = useRef(null)
useMorph(row, `${kind}:${found === null}`)
const reset = () => { setKind(null); setName(''); setUrl(''); setCommand(''); setFound(null); setPicked([]) }
const choose = (next) => {
setKind(next)
if (next === 'import' && found === null) void Promise.resolve(actions.connectorImportScan()).then(list => setFound(Array.isArray(list) ? list : list?.items ?? []), () => setFound([]))
}
const key = (item) => `${item.source}:${item.name}`
const ready = name.trim() !== '' && (kind === 'url' ? url.trim() !== '' : command.trim() !== '')
return h('div', { ref: row, className: 'bt-connector', 'data-state': 'off' },
h('div', { className: 'bt-connector-head' },
h('span', { className: 'bt-connector-mark' }, h(ConnectorMark, { connector: { id: 'custom', name: '+' } })),
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-connector-name' }, t('Other MCP server')),
h('span', { className: 'bt-connector-status' }, t('An address, a command, or one from Claude Desktop, Cursor, or VS Code'))),
kind === null ? h('span', { className: 'bt-connector-actions' }, h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: () => choose('url') }, t('Add'))) : null),
kind === null ? null : h('div', { className: 'bt-connector-form' },
h(Segmented, { label: t('Kind of server'), value: kind },
[['url', t('Address')], ['command', t('Command')], ['import', t('Import from other apps')]].map(([id, label]) => h('button', { key: id, type: 'button', 'aria-pressed': kind === id, onClick: () => choose(id) }, label))),
kind === 'import'
? (found === null ? h('span', { className: 'bt-set-hint' }, t('Scanning…'))
: found.length === 0 ? h('span', { className: 'bt-set-hint' }, t('No MCP servers found in Claude Desktop, Cursor, or VS Code settings.'))
: h('div', { className: 'bt-mail-rules' }, found.map(item => h('div', { key: key(item), className: 'bt-mail-rule' },
h('span', { className: 'bt-connector-text' },
h('span', { className: 'bt-mail-rule-name' }, item.name),
h('span', { className: 'bt-connector-status' }, `${item.source} · ${item.url ?? item.command}`)),
h(Switch, { label: item.name, on: picked.some(p => key(p) === key(item)), onChange: on => setPicked(list => on ? [...list, { source: item.source, name: item.name }] : list.filter(p => key(p) !== key(item))) })))))
: [
h('input', { key: 'name', className: 'bt-input', 'aria-label': t('Name'), placeholder: t('Name'), value: name, onChange: e => setName(e.target.value) }),
kind === 'url'
? h('input', { key: 'url', className: 'bt-input', 'aria-label': t('Server address'), placeholder: 'https://…', value: url, spellCheck: false, onChange: e => setUrl(e.target.value) })
: h('input', { key: 'cmd', className: 'bt-input', 'aria-label': t('Command'), placeholder: t('Command, e.g. npx -y some-mcp'), value: command, spellCheck: false, onChange: e => setCommand(e.target.value) }),
],
h('div', { className: 'bt-secret-row-actions' },
h('button', { type: 'button', className: 'bt-soft bt-soft-sm', onClick: reset }, t('Cancel')),
kind === 'import'
? h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: picked.length === 0, onClick: () => void run(actions.connectorImport(picked), reset) }, t('Import {count}', { count: picked.length }))
: h('button', { type: 'button', className: 'bt-soft bt-soft-sm', disabled: !ready, onClick: () => void run(kind === 'url' ? actions.connectorAdd({ name: name.trim(), url: url.trim() }) : actions.connectorAdd({ name: name.trim(), command: command.trim() }), reset) }, t('Add')))))
}
// Bot details → Connectors: one switch per connected connector (default on).
export function BotConnectors({ bot, roster, actions, run }) {
const data = roster?.connectors
const list = (data?.connectors ?? []).filter(c => c.state === 'ready')
const mailOn = (data?.mail?.accounts ?? []).length > 0
if (list.length === 0 && !mailOn) return null
const rows = [...list, ...(mailOn ? [{ id: 'mail', name: t('Mailbox'), offFor: (data.mail?.offFor ?? []) }] : [])]
return h('div', { className: 'bt-drawer-model' },
h('div', { key: 't', className: 'bt-section-title' }, t('Connectors')),
rows.map((connector) => {
const off = (connector.offFor ?? []).includes(bot.id)
return h(SwitchRow, { key: connector.id, label: connector.name, on: !off, onChange: (checked) => {
const next = checked ? (connector.offFor ?? []).filter(id => id !== bot.id) : [...(connector.offFor ?? []), bot.id]
void run(actions.connectorSet(connector.id, { offFor: next }))
} })
}))
}
// --- cards ---------------------------------------------------------------
// The request cards are view cards (the show_view card): a title, text blocks,
// and a confirm row. Answered requests settle into the same card, read-only.
// Bot-written text shows exactly as written: Markdown is escaped so nothing in
// it renders, links, or hides.
const literal = text => String(text ?? '').replace(/[\\`*_{}[\]()#+\-.!|<>~&@:]/g, '\\$&')
const MailIcon = () => h('svg', { width: 14, height: 14, viewBox: '0 0 20 20', fill: 'none', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round', 'aria-hidden': true },
h('rect', { x: 2.5, y: 4.5, width: 15, height: 11, rx: 2 }),
h('path', { d: 'M3 5.5l7 5 7-5' }))
// A view card that holds the dock while the user works in it.
function RequestView({ sessionId, kind, request, actions, inline, title, icon, footStart, view, onAnswer, busy = false }) {
const hold = useDockHold(sessionId, kind, request.id, actions, inline)
return h('div', { style: { display: 'contents' }, onFocusCapture: hold, onPointerDownCapture: hold },
h(ViewCard, {
title, icon, footStart, view, busy, raised: !inline,
onSubmit: (_, values) => { hold(); onAnswer(values) },
onDismiss: () => { hold(); onAnswer({ canceled: true }) },
}))
}
const connectorView = (request, settled = false) => ({
type: 'stack',
children: [
request.purpose ? { type: 'text', text: literal(request.purpose) } : null,
{ type: 'confirm', id: 'connect', confirmLabel: settled ? t('Connected') : t('Connect'), cancelLabel: settled ? t('Canceled') : t('Dismiss') },
].filter(Boolean),
})
function ConnectorCard({ sessionId, bot, request, actions, inline = false }) {
const name = request.name ?? request.connectorId
return h(RequestView, {
sessionId, kind: 'connector', request, actions, inline,
title: t('{bot} needs {name}', { bot: bot.name, name }),
view: connectorView(request),
onAnswer: values => { if (values?.confirmed === true) actions.openConnectors(); else void actions.connectorRequestCancel(request.id) },
})
}
function SettledConnector({ bot, request }) {
return h(ViewCard, {
title: t('{bot} needs {name}', { bot: bot.name, name: request.name ?? request.connectorId }),
view: connectorView(request, true),
settled: true,
answer: { action: 'connect', values: { confirmed: request.status === 'connected' } },
})
}
const humanSize = bytes => bytes >= 1024 * 1024 ? `${(bytes / (1024 * 1024)).toFixed(1)} MB` : bytes >= 1024 ? `${Math.round(bytes / 1024)} KB` : `${bytes} B`
const NONE = {}
export function ConnectorToolCell({ sessionId, callId, done, content, roster, actions, heldCards = NONE }) {
const bot = roster.byId[sessionId]
if (!bot) return h(CellEmpty)
const request = (roster.connectorRequests?.[bot.id] ?? []).find(entry => entry.callId === callId && (entry.sessionId ?? sessionId) === sessionId)
if (request?.status === 'pending' && heldCards[heldCardKey('connector', request.id)] > 0) return h(CellEmpty)
if (request) {
return request.status === 'pending'
? h('div', { className: 'bt-q-inline' }, h(ConnectorCard, { sessionId, bot, request, actions, inline: true }))
: h('div', { className: 'bt-q-inline' }, h(SettledConnector, { bot, request }))
}
if (done && /already connected/.test(contentText(content))) return h(CellEmpty)
return h(CellEmpty)
}
export function ConnectorDock({ sessionId, useRoster, useCards, useHeldCards, actions }) {
const roster = useRoster(value => value)
const shown = useCards?.(state => state[sessionId]) ?? NONE
const held = useHeldCards?.(state => state[sessionId]) ?? NONE
const bot = roster.byId[sessionId]
if (!bot || currentPart(bot) !== sessionId) return null
const drawn = entry => entry.callId && entry.sessionId === sessionId && shown[entry.callId] > 0 && !(held[heldCardKey('connector', entry.id)] > 0)
const waiting = (roster.connectorRequests?.[bot.id] ?? []).filter(entry => entry.status === 'pending' && !drawn(entry))
if (waiting.length === 0) return null
return h('div', { className: 'bt-q-dock bt-secret-dock' }, waiting.map(request => h(ConnectorCard, { key: request.id, sessionId, bot, request, actions })))
}
const RULE_LABELS = {
'allow-recipient': 'Allow recipient',
'require-approval': 'Needs approval',
'no-draft': 'Allow this Bot to send directly',
}
function MailApprovalMenu({ bot, request, rule, onPick, actions, disabled = false }) {
const [open, setOpen] = useState(false)
const root = useRef(null)
useEffect(() => {
if (!open) return undefined
const away = (event) => { if (!root.current?.contains(event.target)) setOpen(false) }
const key = (event) => { if (event.key === 'Escape') setOpen(false) }
document.addEventListener('pointerdown', away, true)
document.addEventListener('keydown', key)
return () => { document.removeEventListener('pointerdown', away, true); document.removeEventListener('keydown', key) }
}, [open])
const choose = (mode) => {
setOpen(false)
onPick(mode)
void Promise.resolve(actions.mailRuleSet?.({
mode,
botId: bot.id,
recipients: [request.to, request.cc, request.bcc].filter(Boolean).join(', '),
})).catch(() => {})
}
return h('div', { ref: root, className: 'bt-mail-rule-wrap' },
h('button', {
type: 'button', className: 'bt-mail-rule-btn', disabled,
'aria-haspopup': 'menu', 'aria-expanded': open,
onClick: () => setOpen(v => !v),
}, t(RULE_LABELS[rule] ?? 'Needs approval'), h(ChevronDownIcon)),
open ? h('div', { className: 'dv-menu bt-mail-rule-menu', role: 'menu' },
['allow-recipient', 'require-approval', 'no-draft'].map(mode => h('button', {
key: mode, type: 'button', role: 'menuitemradio', 'aria-checked': rule === mode,
onClick: () => choose(mode),
}, h('span', { className: 'bt-mail-rule-item-text' }, t(RULE_LABELS[mode])), rule === mode ? h(CheckIcon) : null)),
h('div', { className: 'dv-menu-sep', role: 'separator' }),
h('button', {
type: 'button', role: 'menuitem',
onClick: () => { setOpen(false); actions.openConnectors?.() },
}, h('span', { className: 'bt-mail-rule-item-text' }, t('Manage rules')))) : null)
}
function mailFrom(request, roster) {
const account = (roster?.connectors?.mail?.accounts ?? []).find(entry => entry.id === request.account)
return account?.address ?? request.account ?? ''
}
// The mail draft card is a show_view form card: the user can edit the subject,
// recipients, CC, and body right in the card before pressing Send, or discard it.
function mailView(request, roster, settled = false) {
const from = mailFrom(request, roster)
const attachments = request.attachmentDetails?.length
? t('Attachments: {names}', { names: request.attachmentDetails.map(a => a.size !== undefined ? `${a.name} (${humanSize(a.size)})` : a.name).join(', ') })
: ''
const done = request.status === 'sent' ? t('Sent') : request.status === 'failed' ? t('Failed') : t('Send')
const fields = [
{ id: 'subject', label: '', value: String(request.subject ?? ''), placeholder: t('Subject') },
{ id: 'from', label: t('From'), value: String(from), readOnly: true },
{ id: 'to', label: t('To'), value: String(request.to ?? ''), placeholder: '[email protected]' },
...(settled && !request.cc ? [] : [{ id: 'cc', label: t('Cc'), value: String(request.cc ?? ''), placeholder: '[email protected]' }]),
...(request.bcc ? [{ id: 'bcc', label: t('Bcc'), value: String(request.bcc ?? ''), placeholder: '[email protected]' }] : []),
{ id: 'body', label: '', value: String(request.body ?? ''), multiline: true, placeholder: t('Write a message…') },
]
return {
type: 'stack',
children: [
{
type: 'form',
id: 'send',
submitLabel: settled ? done : t('Send'),
cancelLabel: settled ? t('Discarded') : t('Discard'),
fields,
},
attachments ? { type: 'text', tone: 'muted', text: literal(attachments) } : null,
].filter(Boolean),
}
}
export function MailSendCard({ sessionId, bot, request, roster, actions, inline = false }) {
const [busy, setBusy] = useState(false)
const [rule, setRule] = useState('require-approval')
const busyRef = useRef(false)
const answer = (values) => {
if (busyRef.current) return
busyRef.current = true
setBusy(true)
const send = values?.canceled !== true && values?.fields !== undefined
void Promise.resolve(actions.mailSendAnswer(request.id, send ? 'send' : 'cancel', send ? { fields: values.fields, rule } : { rule })).catch(() => {}).finally(() => { busyRef.current = false; setBusy(false) })
}
return h(RequestView, {
sessionId, kind: 'mail', request, actions, inline, busy,
title: t('Mail'),
icon: h(MailIcon),
footStart: h(MailApprovalMenu, { bot, request, rule, onPick: setRule, actions, disabled: busy }),
view: mailView(request, roster),
onAnswer: answer,
})
}
function SettledMail({ request, roster }) {
const from = mailFrom(request, roster)
const sent = request.status === 'sent' || request.status === 'failed'
return h(ViewCard, {
title: t('Mail'),
icon: h(MailIcon),
view: mailView(request, roster, true),
settled: true,
answer: {
action: 'send',
values: sent
? { fields: { subject: String(request.subject ?? ''), from: String(from), to: String(request.to ?? ''), cc: String(request.cc ?? ''), bcc: String(request.bcc ?? ''), body: String(request.body ?? '') } }
: { canceled: true },
},
})
}
export function MailToolCell({ sessionId, callId, roster, actions, heldCards = NONE }) {
const bot = roster.byId[sessionId]
if (!bot) return h(CellEmpty)
const request = (roster.mailRequests?.[bot.id] ?? []).find(entry => entry.callId === callId && (entry.sessionId ?? sessionId) === sessionId)
if (request?.status === 'pending' && heldCards[heldCardKey('mail', request.id)] > 0) return h(CellEmpty)
if (request) {
return request.status === 'pending'
? h('div', { className: 'bt-q-inline' }, h(MailSendCard, { sessionId, bot, request, roster, actions, inline: true }))
: h('div', { className: 'bt-q-inline' }, h(SettledMail, { bot, request, roster }))
}
return h(CellEmpty)
}
export function MailDock({ sessionId, useRoster, useCards, useHeldCards, actions }) {
const roster = useRoster(value => value)
const shown = useCards?.(state => state[sessionId]) ?? NONE
const held = useHeldCards?.(state => state[sessionId]) ?? NONE
const bot = roster.byId[sessionId]
if (!bot || currentPart(bot) !== sessionId) return null
const drawn = entry => entry.callId && entry.sessionId === sessionId && shown[entry.callId] > 0 && !(held[heldCardKey('mail', entry.id)] > 0)
const waiting = (roster.mailRequests?.[bot.id] ?? []).filter(entry => entry.status === 'pending' && !drawn(entry))
if (waiting.length === 0) return null
return h('div', { className: 'bt-q-dock bt-secret-dock' }, waiting.map(request => h(MailSendCard, { key: request.id, sessionId, bot, request, roster, actions })))
}
export const CONNECTOR_CSS = `
.bt-connector-mono{display:inline-flex;width:20px;height:20px;border-radius:6px;align-items:center;justify-content:center;background:var(--bt-accent);color:var(--bt-card);font-size:12px;font-weight:600;filter:hue-rotate(calc(var(--bt-hue,0)*1deg))}
.bt-connector-name{display:inline-flex;align-items:center;gap:6px}
.bt-connector-search{display:flex;flex-direction:column;gap:8px;padding:12px}
.bt-connector-chips{display:flex;flex-wrap:wrap;gap:6px}
.bt-connector-chips .bt-secret-seg{height:26px;padding:0 10px;border:.5px solid var(--bt-line)}
.bt-connector-chips .bt-secret-seg[aria-pressed=true]{background:var(--bt-active)}
.bt-connector-ro{padding-left:48px}
.bt-connector-device{display:flex;align-items:center;gap:10px}
.bt-connector-code{font-family:ui-monospace,Menlo,monospace;font-size:16px;letter-spacing:.12em;padding:4px 10px;border-radius:8px;background:var(--bt-hover)}
.bt-connector-bot .bt-set-copy{min-width:0}
.bt-mail-rule-wrap{position:relative;display:inline-flex;align-items:center}
.bt-mail-rule-btn{display:inline-flex;align-items:center;gap:4px;height:30px;padding:0 8px;border:0;border-radius:8px;background:none;color:var(--bt-ink-2);font:inherit;font-size:13px;font-weight:500;cursor:pointer;transition:background-color .12s ease,color .12s ease}
.bt-mail-rule-btn:hover:not(:disabled){background:var(--bt-hover);color:var(--bt-ink)}
.bt-mail-rule-btn:disabled{opacity:.4;cursor:default}
.bt-mail-rule-btn svg{width:13px;height:13px;color:var(--bt-ink-2)}
.dv-menu.bt-mail-rule-menu{position:absolute;left:0;bottom:calc(100% + 6px);z-index:20;min-width:190px;--dv-origin:bottom left}
.dv-menu.bt-mail-rule-menu button{justify-content:space-between;gap:12px}
.bt-mail-rule-item-text{flex:1 1 auto;min-width:0}
.dv-widget-stack:has(>.dv-widget-form){gap:8px}
.dv-widget-stack>.dv-widget-form{display:contents}
.dv-widget-stack>.dv-widget-form>.dv-q-foot{order:2;padding-top:4px}
.dv-widget-field[data-multiline] .dv-q-field{flex:1 1 auto}
.dv-q-textarea{field-sizing:content;min-height:66px;max-height:240px;overflow-y:auto;line-height:22px}
`