import { html, nothing } from 'lit'; import { unsafeHTML } from 'lit/directives/unsafe-html.js'; import { LightElement } from '../lib/base.js'; import { t } from '../lib/i18n.js'; import { authLabel, connectorIconUrl, statusOf, STATUS_LABEL, statusText } from './shared/connector-common.js'; // Connectors (MCP) — blueprint §7/§14/§15. // // **One row per connector**, not one per runtime instance. A catalog entry is a // template with two runtimes (§7), and a person thinks in terms of "do I have // Gmail?" — not "how many `mcp_user_servers` rows named gmail-ish do I own?". So the // old three-section split (Mine / Global / Available) is gone: the same connector // used to appear twice, once as a template and once as its instance, and the reader // had to join the two by eye. Here each connector appears exactly once, and its // state is a chip on the row. // // This page is also where the admin **curates** the list: adding is one intent with // two sources, so it is one button with two options rather than two distant // affordances. Their order mirrors the trust model (§14): the marketplace path is // vetted and hash-verified, the manual path is the escape hatch that puts unvetted // code on the box — which is why it needs `mcp.register_local_script` and why it // sits second. Removing a catalog entry lives on the row itself. // // The row is a link, not a form. Everything that needs typing lives on the // connector's own page (`#connector?name=X`) — an activation form has as many // fields as the connector declares (EMAIL has a dozen), which a fixed-size dialog // could never hold. The manual-add path is a dedicated sub-page (`#connectors/new`) // for the same reason: the form is long and technical, a fixed modal grew taller // than the viewport with no way to scroll, and a click on the overlay discarded // everything typed so far. A page scrolls, and leaving it is a deliberate // navigation. // // Row-list styling lives in `web/css/connectors.css`. const ADMIN_ID = 'admin'; async function jf(url, opts) { const res = await fetch(url, opts); if (!res.ok) throw new Error(await res.text() || `HTTP ${res.status}`); const ct = res.headers.get('content-type') || ''; return ct.includes('application/json') ? res.json() : null; } export class ConnectorsPage extends LightElement { static get properties() { return { _open: { state: true }, _me: { state: true }, // { role_id } _available: { state: true }, // { catalog: [...], globals: [...] } _activated: { state: true }, // my per-user server rows _error: { state: true }, _q: { state: true }, _noIcon: { state: true }, // names whose icon failed to load _addOpen: { state: true }, // admin: the "Add connector" chooser _view: { state: true }, // admin: 'list' | 'new' _form: { state: true }, // admin: manual-entry fields, when _view === 'new' _providers: { state: true }, // admin: OAuth provider list (modal) _pForm: { state: true }, // admin: provider being edited, or null _pError: { state: true }, }; } constructor() { super(); this._open = false; this._q = ''; this._noIcon = new Set(); this._reset(); } _reset() { this._me = null; this._available = null; this._activated = null; this._error = null; this._addOpen = false; this._view = 'list'; this._form = null; this._providers = null; this._pForm = null; this._pError = null; } connectedCallback() { super.connectedCallback(); this.__onLocaleChanged = () => this.requestUpdate(); window.addEventListener('locale-changed', this.__onLocaleChanged); window.addEventListener('llm-page-change', (e) => { this._open = e.detail.page === 'connectors'; this.style.display = this._open ? 'flex' : 'none'; if (this._open) { this._syncViewFromHash(); this._load(); } }); window.addEventListener('hashchange', () => { if (this._open) this._syncViewFromHash(); }); window.addEventListener('connectors-changed', () => { if (this._open) this._load(); }); document.addEventListener('click', () => { if (this._addOpen) this._addOpen = false; }); } disconnectedCallback() { window.removeEventListener('locale-changed', this.__onLocaleChanged); super.disconnectedCallback(); } get _isAdmin() { return this._me?.role_id === ADMIN_ID; } async _load() { this._error = null; try { this._me = await jf('/api/auth/me'); const [available, activated] = await Promise.all([ jf('/api/mcp/available'), jf('/api/mcp/activated'), ]); this._available = available; this._activated = activated; } catch (e) { this._error = e.message; } } _go(page, hash) { this._addOpen = false; history.pushState({ page }, '', hash); window.dispatchEvent(new CustomEvent('llm-page-change', { detail: { page } })); } _openConnector(name) { this._go('connector', `#connector?name=${encodeURIComponent(name)}`); } // ── admin: add ─────────────────────────────────────────────────────────────── // The `new` view is derived from the `#connectors/new` sub-route, so the // browser's Back/Forward works and a pasted URL lands on the form. Entering the // view always starts a fresh form. _syncViewFromHash() { const parts = location.hash.slice(1).split('/'); const wantsNew = parts[0] === 'connectors' && parts[1] === 'new'; if (wantsNew && this._view !== 'new') { this._error = null; this._form = { name: '', scope: 'per_user', source: 'remote', transport: 'stdio', command: '', args: '', url: '', script_path: '', config_schema: '', auth_kind: 'none', friendly_name: '', description: '', }; } this._view = wantsNew ? 'new' : 'list'; } _openManual() { this._addOpen = false; history.pushState({ page: 'connectors', view: 'new' }, '', '#connectors/new'); this._syncViewFromHash(); } _closeNew() { // Prefer real history so the browser's own Back stays consistent; fall back to // the list when this page was opened straight from a pasted URL. if (history.length > 1) { history.back(); return; } history.pushState({ page: 'connectors' }, '', '#connectors'); this._view = 'list'; } _patch(field, value) { this._form = { ...this._form, [field]: value }; } async _saveManual() { const f = this._form; if (!f.name.trim()) { this._error = t('connectors.new.error_name'); return; } const listField = (s) => s.split(/[\n,]/).map(x => x.trim()).filter(Boolean); try { await jf('/api/mcp/catalog', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name: f.name.trim(), scope: f.scope, source: f.source, transport: f.transport, command: f.command.trim() || null, args: f.args.trim() ? listField(f.args) : null, url: f.url.trim() || null, script_path: f.script_path.trim() || null, config_schema: f.config_schema.trim() ? listField(f.config_schema) : null, auth_kind: f.auth_kind, friendly_name: f.friendly_name.trim() || null, description: f.description.trim() || null, }), }); this._view = 'list'; this._form = null; history.pushState({ page: 'connectors' }, '', '#connectors'); await this._load(); } catch (e) { this._error = e.message; } } async _delete(row) { if (!confirm(t('connectors.confirm.remove', { name: row.name }))) return; try { await jf(`/api/mcp/catalog/${row.id}`, { method: 'DELETE' }); await this._load(); } catch (e) { this._error = e.message; } } // ── admin: OAuth sign-in providers (§15) ───────────────────────────────────── async _openProviders() { this._pError = null; this._pForm = null; try { this._providers = await jf('/api/mcp/providers'); } catch (e) { this._pError = e.message; this._providers = []; } } _closeProviders() { this._providers = null; this._pForm = null; this._pError = null; } _blankProvider() { return { name: '', display_name: '', auth_url: '', token_url: '', client_id: '', client_secret: '', redirect_uri: '', extra_params: '' }; } /// A Google preset — fills everything but the client_id/secret the admin pastes /// from their Google Cloud console. `prompt=consent` + `access_type=offline` are /// what make Google return a refresh token (§15). _presetGoogle() { this._pError = null; this._pForm = { name: 'google', display_name: 'Google', auth_url: 'https://accounts.google.com/o/oauth2/v2/auth', token_url: 'https://oauth2.googleapis.com/token', client_id: '', client_secret: '', redirect_uri: 'https://connectors.skaldagent.net/oauth/show.html', extra_params: '{"access_type":"offline","prompt":"consent"}', _isNew: true, }; } _editProvider(p) { // The secret never came back from the server; an empty box means "keep it". this._pForm = { ...p, client_secret: '', extra_params: p.extra_params || '', _isNew: false }; this._pError = null; } _patchProvider(key, value) { this._pForm = { ...this._pForm, [key]: value }; } async _saveProvider() { const f = this._pForm; if (!f.name.trim() || !f.client_id.trim()) { this._pError = t('connectors.providers.error.name_client'); return; } if (f._isNew && !f.client_secret.trim()) { this._pError = t('connectors.providers.error.secret'); return; } this._pError = null; try { const { _isNew, has_client_secret, ...body } = f; await jf('/api/mcp/providers', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body), }); this._pForm = null; this._providers = await jf('/api/mcp/providers'); } catch (e) { this._pError = e.message; } } async _deleteProvider(name) { if (!confirm(t('connectors.providers.delete_confirm', { name }))) return; try { await jf(`/api/mcp/providers/${encodeURIComponent(name)}`, { method: 'DELETE' }); this._providers = await jf('/api/mcp/providers'); } catch (e) { this._pError = e.message; } } /// The merged view: every connector the caller can see, exactly once, carrying /// whichever runtime rows exist for it. get _rows() { const catalog = this._available?.catalog ?? []; const globals = this._available?.globals ?? []; const activated = this._activated ?? []; const rows = catalog.map(e => ({ ...e, _act: activated.find(r => r.catalog_name === e.name) ?? null, _glob: globals.find(g => (g.catalog_name ?? g.name) === e.name) ?? null, })); // A granted global whose catalog row the caller cannot see. `/api/mcp/available` // only returns `global` catalog entries to a catalog manager, so without this the // connector an ordinary user actually uses every day would be missing from their // own list — visible to the admin, invisible to its user. for (const g of globals) { const key = g.catalog_name ?? g.name; if (rows.some(r => r.name === key)) continue; rows.push({ name: key, friendly_name: g.friendly_name, description: g.description, scope: 'global', source: 'remote', auth_kind: 'none', _act: null, _glob: g, }); } const q = this._q.trim().toLowerCase(); return rows .filter(r => !q || r.name.toLowerCase().includes(q) || (r.friendly_name ?? '').toLowerCase().includes(q) || (r.description ?? '').toLowerCase().includes(q)) .sort((a, b) => (a.friendly_name || a.name).localeCompare(b.friendly_name || b.name)); } _iconFailed(name) { // Re-render with the placeholder. A synthetic row (a granted global whose // catalog entry the caller cannot read) has no icon path to check up front, so // the 404 is the check. const next = new Set(this._noIcon); next.add(name); this._noIcon = next; } // ── Render ───────────────────────────────────────────────────────────────── render() { if (!this._open) return nothing; if (this._view === 'new') return this._renderNew(); const loading = this._available === null && !this._error; const rows = loading ? [] : this._rows; return html`
${t('connectors.empty.match', { query: this._q })}
${this._isAdmin ? t('connectors.empty.installed') : t('connectors.empty.available')}
${this._isAdmin ? html`${t('connectors.empty.install_hint')}
` : html`${t('connectors.empty.ask_admin')}
`}${t('connectors.providers.empty')}
${p.name}