Something went wrong. Try again.
The agent that grows with you
Something went wrong. Try again.
15 kB · 526 lines
TypeScript
at bb/theme
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527const BASE = "";
import type { DashboardTheme } from "@/themes/types";
// Ephemeral session token for protected endpoints.// Injected into index.html by the server — never fetched via API.declare global { interface Window { __HERMES_SESSION_TOKEN__?: string; }}let _sessionToken: string | null = null;const SESSION_HEADER = "X-Hermes-Session-Token";
function setSessionHeader(headers: Headers, token: string): void { if (!headers.has(SESSION_HEADER)) { headers.set(SESSION_HEADER, token); }}
export async function fetchJSON<T>(url: string, init?: RequestInit): Promise<T> { // Inject the session token into all /api/ requests. const headers = new Headers(init?.headers); const token = window.__HERMES_SESSION_TOKEN__; if (token) { setSessionHeader(headers, token); } const res = await fetch(`${BASE}${url}`, { ...init, headers }); if (!res.ok) { const text = await res.text().catch(() => res.statusText); throw new Error(`${res.status}: ${text}`); } return res.json();}
async function getSessionToken(): Promise<string> { if (_sessionToken) return _sessionToken; const injected = window.__HERMES_SESSION_TOKEN__; if (injected) { _sessionToken = injected; return _sessionToken; } throw new Error("Session token not available — page must be served by the Hermes dashboard server");}
export const api = { getStatus: () => fetchJSON<StatusResponse>("/api/status"), getSessions: (limit = 20, offset = 0) => fetchJSON<PaginatedSessions>(`/api/sessions?limit=${limit}&offset=${offset}`), getSessionMessages: (id: string) => fetchJSON<SessionMessagesResponse>(`/api/sessions/${encodeURIComponent(id)}/messages`), deleteSession: (id: string) => fetchJSON<{ ok: boolean }>(`/api/sessions/${encodeURIComponent(id)}`, { method: "DELETE", }), getLogs: (params: { file?: string; lines?: number; level?: string; component?: string }) => { const qs = new URLSearchParams(); if (params.file) qs.set("file", params.file); if (params.lines) qs.set("lines", String(params.lines)); if (params.level && params.level !== "ALL") qs.set("level", params.level); if (params.component && params.component !== "all") qs.set("component", params.component); return fetchJSON<LogsResponse>(`/api/logs?${qs.toString()}`); }, getAnalytics: (days: number) => fetchJSON<AnalyticsResponse>(`/api/analytics/usage?days=${days}`), getConfig: () => fetchJSON<Record<string, unknown>>("/api/config"), getDefaults: () => fetchJSON<Record<string, unknown>>("/api/config/defaults"), getSchema: () => fetchJSON<{ fields: Record<string, unknown>; category_order: string[] }>("/api/config/schema"), getModelInfo: () => fetchJSON<ModelInfoResponse>("/api/model/info"), saveConfig: (config: Record<string, unknown>) => fetchJSON<{ ok: boolean }>("/api/config", { method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ config }), }), getConfigRaw: () => fetchJSON<{ yaml: string }>("/api/config/raw"), saveConfigRaw: (yaml_text: string) => fetchJSON<{ ok: boolean }>("/api/config/raw", { method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ yaml_text }), }), getEnvVars: () => fetchJSON<Record<string, EnvVarInfo>>("/api/env"), setEnvVar: (key: string, value: string) => fetchJSON<{ ok: boolean }>("/api/env", { method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ key, value }), }), deleteEnvVar: (key: string) => fetchJSON<{ ok: boolean }>("/api/env", { method: "DELETE", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ key }), }), revealEnvVar: async (key: string) => { const token = await getSessionToken(); return fetchJSON<{ key: string; value: string }>("/api/env/reveal", { method: "POST", headers: { "Content-Type": "application/json", [SESSION_HEADER]: token, }, body: JSON.stringify({ key }), }); },
// Cron jobs getCronJobs: () => fetchJSON<CronJob[]>("/api/cron/jobs"), createCronJob: (job: { prompt: string; schedule: string; name?: string; deliver?: string }) => fetchJSON<CronJob>("/api/cron/jobs", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(job), }), pauseCronJob: (id: string) => fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/pause`, { method: "POST" }), resumeCronJob: (id: string) => fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/resume`, { method: "POST" }), triggerCronJob: (id: string) => fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/trigger`, { method: "POST" }), deleteCronJob: (id: string) => fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}`, { method: "DELETE" }),
// Skills & Toolsets getSkills: () => fetchJSON<SkillInfo[]>("/api/skills"), toggleSkill: (name: string, enabled: boolean) => fetchJSON<{ ok: boolean }>("/api/skills/toggle", { method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name, enabled }), }), getToolsets: () => fetchJSON<ToolsetInfo[]>("/api/tools/toolsets"),
// Session search (FTS5) searchSessions: (q: string) => fetchJSON<SessionSearchResponse>(`/api/sessions/search?q=${encodeURIComponent(q)}`),
// OAuth provider management getOAuthProviders: () => fetchJSON<OAuthProvidersResponse>("/api/providers/oauth"), disconnectOAuthProvider: async (providerId: string) => { const token = await getSessionToken(); return fetchJSON<{ ok: boolean; provider: string }>( `/api/providers/oauth/${encodeURIComponent(providerId)}`, { method: "DELETE", headers: { [SESSION_HEADER]: token }, }, ); }, startOAuthLogin: async (providerId: string) => { const token = await getSessionToken(); return fetchJSON<OAuthStartResponse>( `/api/providers/oauth/${encodeURIComponent(providerId)}/start`, { method: "POST", headers: { "Content-Type": "application/json", [SESSION_HEADER]: token, }, body: "{}", }, ); }, submitOAuthCode: async (providerId: string, sessionId: string, code: string) => { const token = await getSessionToken(); return fetchJSON<OAuthSubmitResponse>( `/api/providers/oauth/${encodeURIComponent(providerId)}/submit`, { method: "POST", headers: { "Content-Type": "application/json", [SESSION_HEADER]: token, }, body: JSON.stringify({ session_id: sessionId, code }), }, ); }, pollOAuthSession: (providerId: string, sessionId: string) => fetchJSON<OAuthPollResponse>( `/api/providers/oauth/${encodeURIComponent(providerId)}/poll/${encodeURIComponent(sessionId)}`, ), cancelOAuthSession: async (sessionId: string) => { const token = await getSessionToken(); return fetchJSON<{ ok: boolean }>( `/api/providers/oauth/sessions/${encodeURIComponent(sessionId)}`, { method: "DELETE", headers: { [SESSION_HEADER]: token }, }, ); },
// Gateway / update actions restartGateway: () => fetchJSON<ActionResponse>("/api/gateway/restart", { method: "POST" }), updateHermes: () => fetchJSON<ActionResponse>("/api/hermes/update", { method: "POST" }), getActionStatus: (name: string, lines = 200) => fetchJSON<ActionStatusResponse>( `/api/actions/${encodeURIComponent(name)}/status?lines=${lines}`, ),
// Dashboard plugins getPlugins: () => fetchJSON<PluginManifestResponse[]>("/api/dashboard/plugins"), rescanPlugins: () => fetchJSON<{ ok: boolean; count: number }>("/api/dashboard/plugins/rescan"),
// Dashboard themes getThemes: () => fetchJSON<DashboardThemesResponse>("/api/dashboard/themes"), setTheme: (name: string) => fetchJSON<{ ok: boolean; theme: string }>("/api/dashboard/theme", { method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name }), }),};
export interface ActionResponse { name: string; ok: boolean; pid: number;}
export interface ActionStatusResponse { exit_code: number | null; lines: string[]; name: string; pid: number | null; running: boolean;}
export interface PlatformStatus { error_code?: string; error_message?: string; state: string; updated_at: string;}
export interface StatusResponse { active_sessions: number; config_path: string; config_version: number; env_path: string; gateway_exit_reason: string | null; gateway_health_url: string | null; gateway_pid: number | null; gateway_platforms: Record<string, PlatformStatus>; gateway_running: boolean; gateway_state: string | null; gateway_updated_at: string | null; hermes_home: string; latest_config_version: number; release_date: string; version: string;}
export interface SessionInfo { id: string; source: string | null; model: string | null; title: string | null; started_at: number; ended_at: number | null; last_active: number; is_active: boolean; message_count: number; tool_call_count: number; input_tokens: number; output_tokens: number; preview: string | null;}
export interface PaginatedSessions { sessions: SessionInfo[]; total: number; limit: number; offset: number;}
export interface EnvVarInfo { is_set: boolean; redacted_value: string | null; description: string; url: string | null; category: string; is_password: boolean; tools: string[]; advanced: boolean;}
export interface SessionMessage { role: "user" | "assistant" | "system" | "tool"; content: string | null; tool_calls?: Array<{ id: string; function: { name: string; arguments: string }; }>; tool_name?: string; tool_call_id?: string; timestamp?: number;}
export interface SessionMessagesResponse { session_id: string; messages: SessionMessage[];}
export interface LogsResponse { file: string; lines: string[];}
export interface AnalyticsDailyEntry { day: string; input_tokens: number; output_tokens: number; cache_read_tokens: number; reasoning_tokens: number; estimated_cost: number; actual_cost: number; sessions: number; api_calls: number;}
export interface AnalyticsModelEntry { model: string; input_tokens: number; output_tokens: number; estimated_cost: number; sessions: number; api_calls: number;}
export interface AnalyticsSkillEntry { skill: string; view_count: number; manage_count: number; total_count: number; percentage: number; last_used_at: number | null;}
export interface AnalyticsSkillsSummary { total_skill_loads: number; total_skill_edits: number; total_skill_actions: number; distinct_skills_used: number;}
export interface AnalyticsResponse { daily: AnalyticsDailyEntry[]; by_model: AnalyticsModelEntry[]; totals: { total_input: number; total_output: number; total_cache_read: number; total_reasoning: number; total_estimated_cost: number; total_actual_cost: number; total_sessions: number; total_api_calls: number; }; skills: { summary: AnalyticsSkillsSummary; top_skills: AnalyticsSkillEntry[]; };}
export interface CronJob { id: string; name?: string; prompt: string; schedule: { kind: string; expr: string; display: string }; schedule_display: string; enabled: boolean; state: string; deliver?: string; last_run_at?: string | null; next_run_at?: string | null; last_error?: string | null;}
export interface SkillInfo { name: string; description: string; category: string; enabled: boolean;}
export interface ToolsetInfo { name: string; label: string; description: string; enabled: boolean; configured: boolean; tools: string[];}
export interface SessionSearchResult { session_id: string; snippet: string; role: string | null; source: string | null; model: string | null; session_started: number | null;}
export interface SessionSearchResponse { results: SessionSearchResult[];}
// ── Model info types ──────────────────────────────────────────────────
export interface ModelInfoResponse { model: string; provider: string; auto_context_length: number; config_context_length: number; effective_context_length: number; capabilities: { supports_tools?: boolean; supports_vision?: boolean; supports_reasoning?: boolean; context_window?: number; max_output_tokens?: number; model_family?: string; };}
// ── OAuth provider types ────────────────────────────────────────────────
export interface OAuthProviderStatus { logged_in: boolean; source?: string | null; source_label?: string | null; token_preview?: string | null; expires_at?: string | null; has_refresh_token?: boolean; last_refresh?: string | null; error?: string;}
export interface OAuthProvider { id: string; name: string; /** "pkce" (browser redirect + paste code), "device_code" (show code + URL), * or "external" (delegated to a separate CLI like Claude Code or Qwen). */ flow: "pkce" | "device_code" | "external"; cli_command: string; docs_url: string; status: OAuthProviderStatus;}
export interface OAuthProvidersResponse { providers: OAuthProvider[];}
/** Discriminated union — the shape of /start depends on the flow. */export type OAuthStartResponse = | { session_id: string; flow: "pkce"; auth_url: string; expires_in: number; } | { session_id: string; flow: "device_code"; user_code: string; verification_url: string; expires_in: number; poll_interval: number; };
export interface OAuthSubmitResponse { ok: boolean; status: "approved" | "error"; message?: string;}
export interface OAuthPollResponse { session_id: string; status: "pending" | "approved" | "denied" | "expired" | "error"; error_message?: string | null; expires_at?: number | null;}
// ── Dashboard theme types ──────────────────────────────────────────────
export interface DashboardThemeSummary { description: string; label: string; name: string; /** Full theme definition for user themes; undefined for built-ins * (which the frontend already has locally). */ definition?: DashboardTheme;}
export interface DashboardThemesResponse { active: string; themes: DashboardThemeSummary[];}
// ── Dashboard plugin types ─────────────────────────────────────────────
export interface PluginManifestResponse { name: string; label: string; description: string; icon: string; version: string; tab: { path: string; position?: string; override?: string; hidden?: boolean; }; entry: string; css?: string | null; has_api: boolean; source: string;}