@maudecode/talaria-web 0.0.0

package/dist/api/settings-router.js

@@ -0,0 +1,474 @@
+/** Settings, profiles, models, providers, reasoning, personalities, onboarding (Python `api/routes.py` handlers of the same paths). */
+import { implement } from '@orpc/server';
+import { RuntimeCredentialError, writeRuntimeCredential } from '../providers/runtime-env.js';
+import { settingsContract } from '@maudecode/talaria-web-contracts';
+import { join } from 'node:path';
+import { HttpError } from './router.js';
+import { requestSessionIdGuard } from './session-visibility.js';
+import { activeProfileName, buildProfileCookie, ensureTrustedAuthSession, sessionCanManageServer } from '../auth/gate.js';
+import { forwardedClientIp, isLoopback, rawPeerIsTrustedProxy } from '../http/origin.js';
+import { isNonGlobalAddress } from '../http/addresses.js';
+import { isIP } from 'node:net';
+import { HttpFailure } from '../sessions/service.js';
+import { SessionNotFound } from '../sessions/store.js';
+import { canonicaliseProviderId, ConfigUnavailable, maxTokensStatus, personalityPrompt, personalityRows, reasoningStatus, setAuxiliaryModel, setDefaultModel, setMaxTokens, validReasoningEffort } from '../config/agent-config.js';
+import { ProfileError, validateProfileName } from '../profiles/profiles.js';
+import { OnboardingError } from '../onboarding.js';
+import { writeEnvFile } from '../providers/env-file.js';
+import { displayName, providerEnvVar } from '../providers/catalog.js';
+import { OAUTH_PROVIDERS } from '../providers/tables.js';
+import { SETTINGS_SPEECH_KEYS, pyBool } from '../settings.js';
+import { str } from '../util.js';
+const os = implement(settingsContract).$context().use(requestSessionIdGuard);
+function failure(error) {
+    if (error instanceof HttpError)
+        throw error;
+    if (error instanceof HttpFailure)
+        throw new HttpError(error.status, error.message, error.extra ?? {});
+    if (error instanceof ProfileError || error instanceof OnboardingError)
+        throw new HttpError(error.status, error.message);
+    if (error instanceof SessionNotFound)
+        throw new HttpError(404, 'Session not found');
+    if (error instanceof ConfigUnavailable)
+        throw new HttpError(503, error.message);
+    throw error;
+}
+/** Handler boundary: contract outputs are pinned loose objects (index signatures), so the concrete return type is erased here like the `as never` casts elsewhere. */
+async function run(fn) {
+    try {
+        return (await fn());
+    }
+    catch (error) {
+        return failure(error);
+    }
+}
+const home = (ctx) => ctx.deps.profileHome(activeProfileName(ctx));
+const truthy = (v) => ['1', 'true', 'yes', 'on'].includes((v ?? '').trim().toLowerCase());
+/** Python `addr.is_loopback or addr.is_private` (`ipaddress` treats every non-global range as private). */
+function ipIsLoopbackOrPrivate(addr) {
+    const ip = addr.trim();
+    if (!isIP(ip))
+        return false;
+    return isLoopback(ip) || isNonGlobalAddress(ip);
+}
+/** Python `_onboarding_request_is_local`: forwarded headers count only behind a trusted proxy with the opt-in. */
+export function onboardingRequestIsLocal(ctx) {
+    const env = ctx.deps.config.env;
+    const trustForwarded = truthy(env.HERMES_WEBUI_TRUST_FORWARDED_FOR);
+    const peerTrusted = rawPeerIsTrustedProxy(ctx.peer, env);
+    if (trustForwarded && peerTrusted) {
+        const client = forwardedClientIp(ctx.headerAll('x-forwarded-for'), ctx.header('x-real-ip'), ctx.peer, env);
+        return client !== null && ipIsLoopbackOrPrivate(client);
+    }
+    if (!ipIsLoopbackOrPrivate(ctx.peer))
+        return false;
+    if (isLoopback(ctx.peer))
+        return true;
+    // A (non-empty) forwarded header on a non-loopback peer means an untrusted relay: fail closed.
+    return !(ctx.headerAll('x-forwarded-for').some((v) => v.trim()) || (ctx.header('x-real-ip') ?? '').trim());
+}
+/** Python `_onboarding_gate_allows`. */
+export async function onboardingGateAllows(ctx, authEnabled) {
+    const enabled = authEnabled ?? (await ctx.deps.auth.isAuthEnabled());
+    if (enabled || truthy(ctx.deps.config.env.HERMES_WEBUI_ONBOARDING_OPEN))
+        return true;
+    return onboardingRequestIsLocal(ctx);
+}
+async function canManageServer(ctx) {
+    return sessionCanManageServer(ctx, await ensureTrustedAuthSession(ctx));
+}
+async function authFields(ctx, into) {
+    const auth = ctx.deps.auth;
+    into.auth_enabled = await auth.isAuthEnabled();
+    into.password_auth_enabled = (await auth.getPasswordHash()) !== null;
+    if (auth.passkeyFeatureFlagEnabled()) {
+        const registered = auth.passkeysEnabled();
+        into.passkeys_enabled = registered;
+        into.passwordless_enabled = registered && !into.password_auth_enabled;
+    }
+    else {
+        into.passkeys_enabled = false;
+        into.passwordless_enabled = false;
+    }
+}
+async function settingsPayload(ctx) {
+    const deps = ctx.deps;
+    const settings = deps.settings.load();
+    settings.persisted_speech_keys = [...SETTINGS_SPEECH_KEYS].filter((k) => k in deps.settings.readRaw()).sort();
+    Reflect.deleteProperty(settings, 'password_hash');
+    Object.assign(settings, { max_tokens: null, max_tokens_effective: null, max_tokens_fallback: null });
+    try {
+        Object.assign(settings, maxTokensStatus(await deps.agentConfig.read(home(ctx))));
+    }
+    catch { /* unavailable: nulls stand */ }
+    settings.password_env_var = Boolean((deps.config.env.HERMES_WEBUI_PASSWORD ?? '').trim());
+    await authFields(ctx, settings);
+    settings.webui_version = deps.version;
+    settings.agent_version = deps.agentVersion();
+    settings.update_channel = str(settings.update_channel) || 'stable';
+    settings.update_channel_version = deps.version;
+    return settings;
+}
+async function saveSettings(ctx, input) {
+    const deps = ctx.deps;
+    const auth = deps.auth;
+    const body = { ...input };
+    if ('bot_name' in body)
+        body.bot_name = str(body.bot_name).trim() || 'Hermes';
+    const authEnabledBefore = await auth.isAuthEnabled();
+    const passwordAuthBefore = authEnabledBefore && (await auth.getPasswordHash()) !== null;
+    const cookie = ctx.authCookie();
+    const loggedInBefore = Boolean(cookie && auth.verifySession(cookie));
+    const requestedPassword = typeof body._set_password === 'string' && body._set_password.trim() !== '';
+    const requestedPasswordless = pyBool(body._passwordless);
+    Reflect.deleteProperty(body, '_passwordless');
+    const requestedClear = pyBool(body._clear_password) || requestedPasswordless;
+    if (requestedPasswordless)
+        body._clear_password = true;
+    if ((requestedPassword || requestedClear) && !(await canManageServer(ctx)))
+        throw new HttpError(403, 'An owner session is required to manage owner authentication credentials');
+    const currentPassword = body._current_password;
+    Reflect.deleteProperty(body, '_current_password');
+    if ((requestedPassword || requestedClear) && (deps.config.env.HERMES_WEBUI_PASSWORD ?? '').trim()) {
+        throw new HttpError(409, 'HERMES_WEBUI_PASSWORD env var is set — it overrides the settings password. Unset the env var and restart the server before changing the password here.');
+    }
+    const maxTokensProvided = 'max_tokens' in body;
+    const maxTokensValue = body.max_tokens;
+    Reflect.deleteProperty(body, 'max_tokens');
+    if (requestedPassword && !authEnabledBefore && !(await onboardingGateAllows(ctx, authEnabledBefore))) {
+        throw new HttpError(403, 'First password setup is only available from local networks when auth is not enabled. To bootstrap this on a remote server, set HERMES_WEBUI_ONBOARDING_OPEN=1.');
+    }
+    if (authEnabledBefore && passwordAuthBefore && (requestedPassword || requestedClear)) {
+        if (typeof currentPassword !== 'string' || !currentPassword)
+            throw new HttpError(403, 'Current password is required to change or disable authentication.');
+        if (!(await auth.verifyPassword(currentPassword)))
+            throw new HttpError(403, 'Current password is incorrect.');
+    }
+    if (requestedPasswordless) {
+        if (!auth.passkeyFeatureFlagEnabled())
+            throw new HttpError(409, 'Passkey support is disabled. Enable HERMES_WEBUI_PASSKEY before going passwordless.');
+        if (!auth.passkeysEnabled())
+            throw new HttpError(409, 'Register a passkey before going passwordless.');
+    }
+    else if (requestedClear)
+        deps.clearPasskeys();
+    const ack = body._auth_disabled_acknowledged;
+    Reflect.deleteProperty(body, '_auth_disabled_acknowledged');
+    if (ack !== undefined && ack !== null && !(await auth.isAuthEnabled()))
+        body.auth_disabled_acknowledged = pyBool(ack);
+    else if ((await auth.isAuthEnabled()) || requestedPassword)
+        body.auth_disabled_acknowledged = false;
+    const saved = await deps.settings.save(body);
+    saved.persisted_speech_keys = [...SETTINGS_SPEECH_KEYS].filter((k) => k in deps.settings.readRaw()).sort();
+    Reflect.deleteProperty(saved, 'password_hash');
+    const cfgHome = home(ctx);
+    try {
+        Object.assign(saved, maxTokensProvided ? await setMaxTokens(deps.agentConfig, cfgHome, maxTokensValue) : maxTokensStatus(await deps.agentConfig.read(cfgHome)));
+    }
+    catch (error) {
+        if (maxTokensProvided)
+            failure(error);
+        Object.assign(saved, { max_tokens: null, max_tokens_effective: null, max_tokens_fallback: null });
+    }
+    const authEnabledAfter = await auth.isAuthEnabled();
+    const authJustEnabled = requestedPassword && authEnabledAfter && !authEnabledBefore;
+    let loggedInAfter = loggedInBefore;
+    if (authJustEnabled && !loggedInBefore) {
+        ctx.queueCookie(ctx.authCookieHeader(auth.createSession({ authType: 'password' })));
+        loggedInAfter = true;
+    }
+    saved.auth_enabled = authEnabledAfter;
+    saved.logged_in = loggedInAfter;
+    saved.auth_just_enabled = authJustEnabled;
+    await authFields(ctx, saved);
+    saved.auth_enabled = authEnabledAfter;
+    return saved;
+}
+const effortsResolver = (ctx) => async (model, provider) => {
+    const sidecar = ctx.deps.sidecar();
+    if (!sidecar)
+        return [];
+    try {
+        return (await sidecar.call('models.reasoning_efforts', { profile_home: home(ctx), model, provider })).efforts;
+    }
+    catch {
+        return [];
+    }
+};
+const OAUTH_UNAVAILABLE = 'Browser OAuth onboarding is not available in this release. Run `hermes auth` in a terminal, then reload.';
+export const settingsRouter = os.router({
+    settings: {
+        get: os.settings.get.handler(({ context: { ctx } }) => run(() => settingsPayload(ctx))),
+        save: os.settings.save.handler(({ input, context: { ctx } }) => run(() => saveSettings(ctx, input))),
+    },
+    profiles: {
+        list: os.profiles.list.handler(({ context: { ctx } }) => run(async () => ({ profiles: await ctx.deps.profiles.list(activeProfileName(ctx)), active: activeProfileName(ctx), single_profile_mode: ctx.deps.isolatedProfileMode() }))),
+        active: os.profiles.active.handler(({ context: { ctx } }) => run(() => ctx.deps.profiles.activePayload(activeProfileName(ctx)))),
+        switch: os.profiles.switch.handler(({ input, context: { ctx } }) => run(async () => {
+            const name = str(input.name ?? input.profile).trim();
+            if (!name)
+                throw new HttpError(400, 'name is required');
+            // Python `switch_profile`: an invalid name is a `ValueError`, which the route answered as 404.
+            if (name !== 'default') {
+                try {
+                    validateProfileName(name);
+                }
+                catch (error) {
+                    throw new HttpError(404, error.message);
+                }
+            }
+            const info = await ensureTrustedAuthSession(ctx);
+            if (ctx.trusted.rejected)
+                throw new HttpError(401, 'Authentication required');
+            const bound = str(info?.bound_profile).trim() || null;
+            if (bound && name !== bound)
+                throw new HttpError(403, 'Profile is bound to the current session');
+            const result = await ctx.deps.profiles.switch(name);
+            ctx.deps.catalog.invalidate();
+            const sessionCookie = ctx.trusted.cookieValue ?? null;
+            if (!(sessionCookie && bound && name === bound))
+                ctx.queueCookie(await buildProfileCookie(ctx, name, sessionCookie));
+            return result;
+        })),
+        create: os.profiles.create.handler(({ input, context: { ctx } }) => run(async () => {
+            if (!(await canManageServer(ctx)))
+                throw new HttpError(403, 'An owner session is required to manage profiles');
+            const name = str(input.name).trim();
+            if (!name)
+                throw new HttpError(400, 'name is required');
+            if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(name))
+                throw new HttpError(400, 'Invalid profile name: lowercase letters, numbers, hyphens, underscores only');
+            const cloneFrom = input.clone_from === null || input.clone_from === undefined ? null : str(input.clone_from).trim();
+            if (cloneFrom !== null && !/^[a-z0-9][a-z0-9_-]{0,63}$/.test(cloneFrom))
+                throw new HttpError(400, 'Invalid clone_from name');
+            const baseUrl = str(input.base_url).trim() || null;
+            if (baseUrl && !/^https?:\/\//.test(baseUrl))
+                throw new HttpError(400, 'base_url must start with http:// or https://');
+            const profile = await ctx.deps.profiles.create({ name, clone_from: cloneFrom, clone_config: pyBool(input.clone_config), base_url: baseUrl, api_key: str(input.api_key).trim() || null, default_model: str(input.default_model).trim() || null, model_provider: str(input.model_provider).trim() || null });
+            return { ok: true, profile: profile };
+        })),
+        delete: os.profiles.delete.handler(({ input, context: { ctx } }) => run(async () => {
+            if (!(await canManageServer(ctx)))
+                throw new HttpError(403, 'An owner session is required to manage profiles');
+            const name = str(input.name ?? input.profile).trim();
+            if (!name)
+                throw new HttpError(400, 'name is required');
+            const active = activeProfileName(ctx);
+            const result = await ctx.deps.profiles.delete(name, active);
+            // A client scoped to the profile it just deleted goes back to `default`; a later write under the stale cookie
+            // would otherwise recreate `profiles/<name>` through the config writer.
+            if (active === name)
+                ctx.queueCookie(await buildProfileCookie(ctx, 'default', ctx.trusted.cookieValue ?? null));
+            return result;
+        })),
+    },
+    models: {
+        list: os.models.list.handler(({ input, context: { ctx } }) => run(() => {
+            const freshness = str(input.freshness).trim().toLowerCase();
+            if (freshness && freshness !== 'session_visit')
+                throw new HttpError(400, `unknown models freshness: ${freshness}`);
+            return ctx.deps.catalog.models(home(ctx));
+        })),
+        live: os.models.live.handler(({ input, context: { ctx } }) => run(() => ctx.deps.catalog.liveModels(home(ctx), str(input.provider)))),
+        refresh: os.models.refresh.handler(({ input, context: { ctx } }) => run(async () => {
+            const provider = str(input.provider).trim().toLowerCase() || null;
+            ctx.deps.catalog.invalidate(home(ctx), provider ?? undefined);
+            ctx.deps.agentConfig.invalidate(home(ctx));
+            return { ok: true, provider, models: await ctx.deps.catalog.models(home(ctx)) };
+        })),
+        auxiliary: os.models.auxiliary.handler(({ context: { ctx } }) => run(async () => {
+            const { auxiliaryModels } = await import('../config/agent-config.js');
+            return auxiliaryModels(await ctx.deps.agentConfig.read(home(ctx)));
+        })),
+        set: os.models.set.handler(({ input, context: { ctx } }) => run(async () => {
+            const scope = str(input.scope).trim();
+            const provider = str(input.provider).trim() || 'auto';
+            const model = str(input.model).trim();
+            try {
+                if (scope === 'auxiliary')
+                    return await setAuxiliaryModel(ctx.deps.agentConfig, home(ctx), str(input.task).trim(), provider, model, input.advanced);
+                if (scope === 'main')
+                    return await setDefaultModel(ctx.deps.agentConfig, home(ctx), model, provider === 'auto' ? null : provider, input.advanced);
+            }
+            catch (error) {
+                if (error instanceof ConfigUnavailable)
+                    throw error;
+                throw new HttpError(400, str(error.message));
+            }
+            finally {
+                ctx.deps.catalog.invalidate();
+            }
+            throw new HttpError(400, `unknown scope: ${scope}`);
+        })),
+        setDefault: os.models.setDefault.handler(({ input, context: { ctx } }) => run(async () => {
+            const provider = str(input.provider).trim().toLowerCase() === 'auto' ? null : input.provider ?? null;
+            try {
+                return await setDefaultModel(ctx.deps.agentConfig, home(ctx), input.model, provider, input.advanced);
+            }
+            catch (error) {
+                if (error instanceof ConfigUnavailable)
+                    throw error;
+                throw new HttpError(400, str(error.message));
+            }
+            finally {
+                ctx.deps.catalog.invalidate();
+            }
+        })),
+    },
+    providers: {
+        list: os.providers.list.handler(({ context: { ctx } }) => run(() => ctx.deps.catalog.providers(home(ctx)))),
+        setKey: os.providers.setKey.handler(({ input, context: { ctx } }) => run(() => setProviderKey(ctx, str(input.provider).trim().toLowerCase(), input.api_key === null || input.api_key === undefined ? null : str(input.api_key).trim() || null))),
+        delete: os.providers.delete.handler(({ input, context: { ctx } }) => run(async () => {
+            const pid = str(input.provider).trim().toLowerCase();
+            // The YAML copy goes first and its failure is the response: a credential deletion is only "removed" once every
+            // persisted source is clear. Provider detection canonicalises ids, so every alias block (`providers.ramp` for
+            // `router`) must go too.
+            const canonical = canonicaliseProviderId(pid);
+            await ctx.deps.agentConfig.update(home(ctx), (c) => {
+                let changed = false;
+                const providers = c.providers;
+                if (providers && typeof providers === 'object' && !Array.isArray(providers)) {
+                    for (const [key, p] of Object.entries(providers)) {
+                        if (canonicaliseProviderId(key) !== canonical)
+                            continue;
+                        if (p && typeof p === 'object' && 'api_key' in p) {
+                            Reflect.deleteProperty(p, 'api_key');
+                            changed = true;
+                        }
+                    }
+                }
+                const model = c.model;
+                if (model && typeof model === 'object' && !Array.isArray(model) && canonicaliseProviderId(model.provider) === canonical && 'api_key' in model) {
+                    Reflect.deleteProperty(model, 'api_key');
+                    changed = true;
+                }
+                return changed;
+            });
+            return setProviderKey(ctx, pid, null);
+        })),
+        selfHosted: os.providers.selfHosted.handler(({ input, context: { ctx } }) => run(async () => { const r = await ctx.deps.onboarding.selfHosted(input); ctx.deps.catalog.invalidate(); return r; })),
+        quota: os.providers.quota.handler(({ input, context: { ctx } }) => run(() => ctx.deps.catalog.quota(home(ctx), str(input.provider).trim() || null, { refresh: truthy(input.refresh) }))),
+        quotas: os.providers.quotas.handler(({ input, context: { ctx } }) => run(() => ctx.deps.catalog.quotas(home(ctx), activeProfileName(ctx), { sourceId: str(input.source).trim() || null, refresh: truthy(input.refresh) }))),
+        costHistory: os.providers.costHistory.handler(({ input, context: { ctx } }) => run(() => {
+            const parsed = Number.parseInt(str(input.days ?? '7').trim() || '7', 10);
+            const days = Number.isFinite(parsed) ? Math.max(1, Math.min(parsed, 365)) : 7;
+            return ctx.deps.catalog.costHistory(home(ctx), str(input.provider).trim() || null, days);
+        })),
+    },
+    reasoning: {
+        get: os.reasoning.get.handler(({ input, context: { ctx } }) => run(async () => reasoningStatus(await ctx.deps.agentConfig.read(home(ctx)), effortsResolver(ctx), { model: input.model ?? null, provider: input.provider ?? null, baseUrl: input.base_url ?? null }))),
+        set: os.reasoning.set.handler(({ input, context: { ctx } }) => run(async () => {
+            const h = home(ctx);
+            if (input.display !== undefined && input.display !== null) {
+                const flag = str(input.display).trim().toLowerCase();
+                let show;
+                if (['show', 'on', 'true', '1'].includes(flag))
+                    show = true;
+                else if (['hide', 'off', 'false', '0'].includes(flag))
+                    show = false;
+                else
+                    throw new HttpError(400, `display must be show|hide|on|off (got '${str(input.display)}')`);
+                const config = await ctx.deps.agentConfig.update(h, (c) => { c.display = { ...(c.display && typeof c.display === 'object' && !Array.isArray(c.display) ? (c.display) : {}), show_reasoning: show }; });
+                return reasoningStatus(config, effortsResolver(ctx));
+            }
+            if (input.effort !== undefined && input.effort !== null) {
+                const raw = str(input.effort).trim().toLowerCase();
+                if (!validReasoningEffort(raw))
+                    throw new HttpError(400, `Unknown reasoning effort '${str(input.effort)}'. Valid: none, minimal, low, medium, high, xhigh, max, ultra.`);
+                const config = await ctx.deps.agentConfig.update(h, (c) => {
+                    const agent = c.agent && typeof c.agent === 'object' && !Array.isArray(c.agent) ? c.agent : {};
+                    if (raw)
+                        agent.reasoning_effort = raw;
+                    else
+                        Reflect.deleteProperty(agent, 'reasoning_effort');
+                    c.agent = agent;
+                });
+                return reasoningStatus(config, effortsResolver(ctx), { model: input.model ?? null, provider: input.provider ?? null, baseUrl: input.base_url ?? null });
+            }
+            throw new HttpError(400, "reasoning: must supply 'display' or 'effort'");
+        })),
+    },
+    personalities: {
+        list: os.personalities.list.handler(({ context: { ctx } }) => run(async () => ({ personalities: personalityRows(await ctx.deps.agentConfig.read(home(ctx))) }))),
+        set: os.personalities.set.handler(({ input, context: { ctx } }) => run(async () => {
+            const sid = str(input.session_id).trim();
+            if (!sid)
+                throw new HttpError(400, 'Missing required field: session_id');
+            if (input.name === undefined)
+                throw new HttpError(400, 'Missing required field: name');
+            const name = str(input.name).trim();
+            if (!ctx.deps.sessions.sessionIdVisible(sid))
+                throw new HttpError(404, 'Session not found');
+            let prompt = '';
+            if (name) {
+                const resolved = personalityPrompt(await ctx.deps.agentConfig.read(home(ctx)), name);
+                if (resolved === null)
+                    throw new HttpError(404, `Personality "${name}" not found in config.yaml`);
+                prompt = resolved;
+            }
+            const personality = await ctx.deps.sessions.setPersonality(sid, name || null);
+            return { ok: true, personality, prompt };
+        })),
+    },
+    onboarding: {
+        status: os.onboarding.status.handler(({ context: { ctx } }) => run(() => ctx.deps.onboarding.status())),
+        setup: os.onboarding.setup.handler(({ input, context: { ctx } }) => run(async () => {
+            if (!(await onboardingGateAllows(ctx)))
+                throw new HttpError(403, 'Onboarding setup is only available from local networks when auth is not enabled. To bypass this on a remote server, set HERMES_WEBUI_ONBOARDING_OPEN=1.');
+            const result = await ctx.deps.onboarding.setup(input);
+            ctx.deps.catalog.invalidate();
+            return result;
+        })),
+        complete: os.onboarding.complete.handler(({ context: { ctx } }) => run(async () => {
+            if (!(await onboardingGateAllows(ctx)))
+                throw new HttpError(403, 'Onboarding is only available from local networks when auth is not enabled. To bypass this on a remote server, set HERMES_WEBUI_ONBOARDING_OPEN=1.');
+            return ctx.deps.onboarding.complete();
+        })),
+        probe: os.onboarding.probe.handler(({ input, context: { ctx } }) => run(async () => {
+            if (!(await onboardingGateAllows(ctx)))
+                throw new HttpError(403, 'Onboarding probe is only available from local networks when auth is not enabled. To bypass this on a remote server, set HERMES_WEBUI_ONBOARDING_OPEN=1.');
+            try {
+                return await ctx.deps.onboarding.probe(str(input.base_url), str(input.api_key).trim() || null);
+            }
+            catch (error) {
+                throw new HttpError(500, `probe failed: ${str(error.message)}`);
+            }
+        })),
+        oauthStart: os.onboarding.oauthStart.handler(({ context: { ctx } }) => run(async () => {
+            if (!(await onboardingGateAllows(ctx)))
+                throw new HttpError(403, 'Onboarding OAuth is only available from local networks when auth is not enabled. To bypass this on a remote server, set HERMES_WEBUI_ONBOARDING_OPEN=1.');
+            throw new HttpError(501, OAUTH_UNAVAILABLE);
+        })),
+        oauthCancel: os.onboarding.oauthCancel.handler(() => run(() => { throw new HttpError(501, OAUTH_UNAVAILABLE); })),
+        oauthPoll: os.onboarding.oauthPoll.handler(() => run(() => { throw new HttpError(501, OAUTH_UNAVAILABLE); })),
+    },
+});
+/** Python `set_provider_key`: `.env` write; `null` removes the key. */
+async function setProviderKey(ctx, pid, apiKey) {
+    if (!pid)
+        throw new HttpError(400, 'provider is required');
+    if (OAUTH_PROVIDERS.has(pid))
+        throw new HttpError(400, `'${displayName(pid)}' uses OAuth authentication. Use \`hermes model\` in the terminal to configure it.`);
+    const envVar = providerEnvVar(pid);
+    if (!envVar)
+        throw new HttpError(400, `Cannot configure API key for '${displayName(pid)}'. This provider does not have a known env var mapping.`);
+    if (apiKey) {
+        if (apiKey.includes('\n') || apiKey.includes('\r'))
+            throw new HttpError(400, 'API key must not contain newline characters.');
+        if (apiKey.length < 8)
+            throw new HttpError(400, 'API key appears too short.');
+    }
+    const envPath = join(home(ctx), '.env');
+    // The running sidecar must confirm the change first: a credential the file no longer holds may not linger in it.
+    try {
+        await writeRuntimeCredential({ env: ctx.deps.config.env, sidecar: ctx.deps.sidecar, log: ctx.deps.log }, ctx.deps.isRootProfile(activeProfileName(ctx)), envVar, apiKey, () => { writeEnvFile(envPath, { [envVar]: apiKey }); });
+    }
+    catch (error) {
+        if (error instanceof RuntimeCredentialError)
+            throw new HttpError(503, error.message);
+        throw new HttpError(400, `Failed to save API key: ${str(error.message)}`);
+    }
+    ctx.deps.catalog.invalidate();
+    return { ok: true, provider: pid, display_name: displayName(pid), action: apiKey ? 'updated' : 'removed' };
+}
+//# sourceMappingURL=settings-router.js.map

package/dist/api/settings-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-router.js","sourceRoot":"","sources":["../../src/api/settings-router.ts"],"names":[],"mappings":"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"}

package/dist/api/sse-routes.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Server-sent event endpoints: the chat relay with journal replay, the
+ * persistent per-session channel, the global session-list feed, the
+ * per-session journal relay, and the approval/clarify prompt feeds
+ * (Python `_handle_sse_stream`, `_handle_session_sse_stream`,
+ * `_handle_session_events_stream`, `_handle_session_run_journal_stream_for_session`).
+ */
+import type { RequestContext } from '../http/context.js';
+import type { GatewayWatcher } from '../sessions/gateway-watcher.js';
+export declare const SSE_HEARTBEAT_INTERVAL_MS = 5000;
+/** Python `promote_request_to_stream`: bounded concurrent SSE clients (503 `client_stream_limit`). */
+export declare class StreamSlots {
+    private readonly limit;
+    private readonly held;
+    constructor(limit: () => number);
+    /** One budget per client identity (authenticated session, else the client address), as Python keyed `_client_stream_key`. */
+    claim(key?: string): (() => void) | null;
+    get active(): number;
+}
+/** Python `_stream_client_key`: the reconciled trusted-auth username (case-folded) when present, else the peer address. */
+export declare function clientStreamKey(ctx: RequestContext): string;
+/** Python served SSE on blocking sockets, so a slow reader stalled its own producer; Node buffers instead, and this bounds that buffer. */
+export declare const SSE_MAX_BUFFERED_BYTES: number;
+export declare class SseWriter {
+    private readonly ctx;
+    private readonly release;
+    private readonly connectionClose;
+    private open;
+    private closed;
+    constructor(ctx: RequestContext, release: () => void, connectionClose: boolean);
+    get isClosed(): boolean;
+    start(): void;
+    event(event: string, data: unknown, eventId?: string | null): void;
+    comment(text: string): void;
+    /** Slow consumers are bounded: past `SSE_MAX_BUFFERED_BYTES` of unsent data the connection is closed instead of growing the response buffer. */
+    private write;
+    end(): void;
+}
+export declare function claimOrReject(ctx: RequestContext, connectionClose: boolean): SseWriter | null;
+export declare function handleChatStream(ctx: RequestContext): Promise<void>;
+/** `/api/session/stream`: the persistent per-session channel. */
+export declare function handleSessionStream(ctx: RequestContext): Promise<void>;
+/** Python `_gateway_sse_probe_payload`: status of the optional gateway stream only, never of `/api/session/stream`. */
+export declare function gatewayProbePayload(ctx: RequestContext, watcher: GatewayWatcher | null): [Record<string, unknown>, number];
+/** `/api/sessions/events`: global session-list invalidation; `?gateway=1` merges the watcher feed with a `stream` discriminator. */
+export declare function handleSessionEvents(ctx: RequestContext): Promise<void>;
+/** `/api/sessions/{sid}/events`: per-session journal relay with snapshot fallback. */
+export declare function handleSessionJournalStream(ctx: RequestContext, sessionId: string): Promise<void>;
+export declare const handleApprovalStream: (ctx: RequestContext) => Promise<void>;
+export declare const handleClarifyStream: (ctx: RequestContext) => Promise<void>;
+export declare function sessionEventsPathSessionId(path: string): string | null;