@olares/lares-core 0.15.0

package/i18n/mobile.js

@@ -0,0 +1,115 @@
+export const ZH = {
+  "shell.title": "Lares",
+  "shell.subtitle": "LarePass 内的对话入口",
+  "probe.idle": "尚未探测 Host",
+  "probe.loading": "正在连接 Lares Host…",
+  "probe.ok": "已连上 Host",
+  "probe.unauthorized": "Host 拒绝了当前登录态（{http}）",
+  "probe.missing": "还没有 Lares 入口地址",
+  "probe.error": "Host 返回 {http}",
+  "probe.unreachable": "连不上 Host：{error}",
+  "probe.retry": "重新探测",
+  "probe.entrance": "入口 {origin}",
+  "chat.empty": "发一条消息开始对话",
+  "chat.placeholder": "发消息或按住说话",
+  "chat.send": "发送",
+  "chat.sending": "正在回复…",
+  "action.copy": "复制",
+  "action.copied": "已复制",
+  "action.like": "点赞",
+  "action.dislike": "点踩",
+  "action.share": "转发",
+  "action.bar": "回复操作",
+  "composer.attach": "添加文件",
+  "composer.voice": "语音输入",
+  "composer.think": "深度思考",
+  "composer.search": "智能搜索",
+  "composer.hold": "松开发送",
+  "composer.searchFailed": "无法切换智能搜索",
+  "chat.failed": "发送失败：{error}",
+  "chat.openFailed": "打不开会话：{error}",
+  "chat.unauthorized": "当前登录态无法访问 Host",
+  "message.contextInjection": "Context injection",
+  "message.contextRecall": "Session recall",
+  "message.retry.active": "Retrying model request",
+  "message.retry.cancelled": "Model request retry cancelled",
+  "message.retry.started": "Retried model request",
+  "message.retry.scheduled": "Waiting to retry model request",
+  "message.retry.status": "{label} ({retry}/{maximum}) · {seconds}s",
+  "message.retry.delay": "Retry delay: ",
+  "message.retry.failure": "Failure reason: ",
+  "bar.history": "历史",
+  "bar.menu": "菜单",
+  "bar.new": "新对话",
+  "bar.newAria": "新对话",
+  "history.empty": "还没有其他对话",
+  "history.untitled": "新对话",
+  "history.loading": "正在加载对话列表…",
+  "chat.loading": "正在加载对话…",
+  "history.today": "今天",
+  "history.week": "之前 7 天",
+  "history.older": "更早",
+  "agent.refresh": "刷新",
+  "agent.loading": "正在读取配置…",
+  "question.title": "需要你选一项",
+  "question.waiting": "正在等待 Host 提问通道…",
+  "question.busy": "正在提交…",
+};
+
+export const EN = {
+  "shell.title": "Lares",
+  "shell.subtitle": "Chat inside LarePass",
+  "probe.idle": "Host not probed yet",
+  "probe.loading": "Connecting to the Lares Host…",
+  "probe.ok": "Host reachable",
+  "probe.unauthorized": "Host rejected this login ({http})",
+  "probe.missing": "No Lares entrance URL yet",
+  "probe.error": "Host returned {http}",
+  "probe.unreachable": "Host unreachable: {error}",
+  "probe.retry": "Probe again",
+  "probe.entrance": "Entrance {origin}",
+  "chat.empty": "Send a message to start chatting",
+  "chat.placeholder": "Message or hold to speak",
+  "chat.send": "Send",
+  "chat.sending": "Replying…",
+  "action.copy": "Copy",
+  "action.copied": "Copied",
+  "action.like": "Like",
+  "action.dislike": "Dislike",
+  "action.share": "Share",
+  "action.bar": "Reply actions",
+  "composer.attach": "Add file",
+  "composer.voice": "Voice input",
+  "composer.think": "Deep think",
+  "composer.search": "Search",
+  "composer.hold": "Release to send",
+  "composer.searchFailed": "Could not toggle search",
+  "chat.failed": "Send failed: {error}",
+  "chat.openFailed": "Could not open a session: {error}",
+  "chat.unauthorized": "This login cannot reach the Host",
+  "message.contextInjection": "Context injection",
+  "message.contextRecall": "Session recall",
+  "message.retry.active": "Retrying model request",
+  "message.retry.cancelled": "Model request retry cancelled",
+  "message.retry.started": "Retried model request",
+  "message.retry.scheduled": "Waiting to retry model request",
+  "message.retry.status": "{label} ({retry}/{maximum}) · {seconds}s",
+  "message.retry.delay": "Retry delay: ",
+  "message.retry.failure": "Failure reason: ",
+  "bar.history": "History",
+  "bar.menu": "Menu",
+  "bar.new": "New chat",
+  "bar.newAria": "New chat",
+  "history.empty": "No other chats yet",
+  "history.untitled": "New chat",
+  "history.loading": "Loading chats…",
+  "chat.loading": "Loading conversation…",
+  "history.today": "Today",
+  "history.week": "Previous 7 days",
+  "history.older": "Older",
+  "agent.refresh": "Refresh",
+  "agent.loading": "Loading settings…",
+  "question.title": "Choose an option",
+  "question.waiting": "Waiting for the Host question channel…",
+  "question.busy": "Submitting…",
+};

package/i18n/preview.js

@@ -0,0 +1,57 @@
+export const ZH = {
+  hierarchy: "会话层级",
+  tabs: "工作区标签页",
+  chat: "对话",
+  preview: "文件预览",
+  produced: "产物",
+  mediaLoading: "正在准备媒体预览…",
+  openInTab: "在标签中打开",
+  download: "下载",
+  close: "关闭 {name}",
+  evicted: "已关闭最久未使用的文件 {name}",
+  empty: "选择一个文件进行预览",
+  loading: "正在加载文件…",
+  failed: "无法预览此文件",
+  retry: "重试",
+  truncated: "文件较大，仅显示前 1 MB 内容。",
+  unsupportedTitle: "暂不支持预览这种文件",
+  unsupported: "目前支持图片、PDF、音视频、Markdown 和文本文件。",
+  "error.file_not_found": "文件不存在或已被移动",
+  "error.file_changed": "文件在打开时发生变化，请重试",
+  "error.path_not_file": "这个路径不是文件，无法预览",
+  "error.file_not_text": "文件不是有效的 UTF-8 文本",
+  "error.file_too_large": "文件超过预览大小限制",
+  "error.path_forbidden": "不能预览工作区外的文件",
+  "error.workspace_not_found": "当前会话没有可用工作区",
+  "error.workspace_unavailable": "当前工作区不可用",
+  "error.file_preview_failed": "文件预览加载失败",
+};
+
+export const EN = {
+  hierarchy: "Session hierarchy",
+  tabs: "Workspace tabs",
+  chat: "Chat",
+  preview: "File preview",
+  produced: "Produced",
+  mediaLoading: "Preparing media preview…",
+  openInTab: "Open in tab",
+  download: "Download",
+  close: "Close {name}",
+  evicted: "Closed least recently used file {name}",
+  empty: "Select a file to preview",
+  loading: "Loading file…",
+  failed: "Unable to preview this file",
+  retry: "Retry",
+  truncated: "This file is large; only the first 1 MB is shown.",
+  unsupportedTitle: "This file type cannot be previewed yet",
+  unsupported: "Images, PDF, audio, video, Markdown, and text files are supported.",
+  "error.file_not_found": "The file no longer exists",
+  "error.file_changed": "The file changed while it was opening; try again",
+  "error.path_not_file": "This path is not a file, so it cannot be previewed",
+  "error.file_not_text": "The file is not valid UTF-8 text",
+  "error.file_too_large": "The file exceeds the preview size limit",
+  "error.path_forbidden": "Files outside the workspace cannot be previewed",
+  "error.workspace_not_found": "No workspace is available for this session",
+  "error.workspace_unavailable": "The current workspace is unavailable",
+  "error.file_preview_failed": "File preview failed to load",
+};

package/i18n/search.js

@@ -0,0 +1,33 @@
+export const ZH = {
+  "settings.title": "网络搜索",
+  "settings.intro": "使用 Router 中已配置的搜索服务，无需在 Lares 中重复填写密钥。",
+  "settings.refresh": "刷新",
+  "settings.refreshing": "刷新中…",
+  "settings.router": "Router 控制台",
+  "settings.loading": "正在读取 Router 搜索服务…",
+  "settings.status.ready": "网络搜索可用 · 默认服务 {model}",
+  "settings.status.notReady": "网络搜索尚不可用，请先在 Olares Router 配置并选择默认搜索服务",
+  "settings.default": "默认搜索服务",
+  "settings.default.none": "未选择",
+  "settings.default.empty": "Router 中没有可用的搜索服务",
+  "settings.loadFailed": "读取 Router 搜索服务失败：{msg}",
+  "settings.refreshFailed": "刷新 Router 搜索服务失败：{msg}",
+  "settings.saveFailed": "设置默认搜索服务失败：{msg}",
+};
+
+export const EN = {
+  "settings.title": "Web search",
+  "settings.intro": "Use a search service configured in Router without entering its credentials again.",
+  "settings.refresh": "Refresh",
+  "settings.refreshing": "Refreshing…",
+  "settings.router": "Router console",
+  "settings.loading": "Loading Router search services…",
+  "settings.status.ready": "Web search ready · default service {model}",
+  "settings.status.notReady": "Web search unavailable; configure and select a default service in Olares Router",
+  "settings.default": "Default search service",
+  "settings.default.none": "None",
+  "settings.default.empty": "No search service is available in Router",
+  "settings.loadFailed": "Failed to load Router search services: {msg}",
+  "settings.refreshFailed": "Failed to refresh Router search services: {msg}",
+  "settings.saveFailed": "Failed to set the default search service: {msg}",
+};

package/i18n/t.js

@@ -0,0 +1,22 @@
+export function interpolate(template, params = {}) {
+  return String(template).replace(/\{(\w+)\}/g, (_, name) =>
+    params[name] == null ? `{${name}}` : String(params[name]),
+  );
+}
+
+function langOf(locale) {
+  const tag = String(locale ?? "en").toLowerCase();
+  return tag === "zh" || tag.startsWith("zh") ? "zh" : "en";
+}
+
+export function t(catalog, locale, key, params) {
+  const table = catalog[langOf(locale)] ?? catalog.en;
+  const raw = table?.[key] ?? catalog.en?.[key] ?? key;
+  return interpolate(raw, params);
+}
+
+export function messageFromCode(translate, code, fallbackKey) {
+  const key = `error.${code}`;
+  const text = translate(key);
+  return text === key ? translate(fallbackKey) : text;
+}

package/i18n/voice.js

@@ -0,0 +1,70 @@
+export const ZH = {
+  "error.voice_permission_denied": "麦克风权限被拒绝",
+  "error.voice_audio_too_large": "录音过长",
+  "error.voice_audio_unreadable": "音频无法识别，请重录",
+  "error.voice_model_unavailable": "语音模型不可用，请先在 Olares 模型控制台安装语音识别应用",
+  "error.voice_timeout": "转写超时，请重试",
+  "error.voice_too_short": "录音太短",
+  "error.voice_no_input": "没有检测到声音",
+  "error.voice_failed": "转写失败，请重试",
+  "error.voice_unsupported": "当前浏览器不支持录音",
+  "mic.stop": "点击结束录音",
+  "mic.transcribing": "转写中…",
+  "mic.idle": "语音输入",
+  "mic.blocked": "当前无法输入",
+  "lang.auto": "自动检测",
+  "status.auto": "自动",
+  "settings.title": "语音输入",
+  "settings.intro": "在输入框旁点击麦克风录音，录完自动转写并填入文本。转写由 Olares Router 的语音模型提供。",
+  "settings.refresh": "刷新",
+  "settings.refreshing": "刷新中…",
+  "settings.router": "Router 控制台",
+  "settings.loading": "正在读取语音输入配置…",
+  "settings.loadFailed": "读取语音输入配置失败",
+  "settings.refreshFailed": "刷新语音模型列表失败",
+  "settings.status.ready": "语音就绪 · 模型 {model}",
+  "settings.status.notReady": "语音模型尚不可用，请先在 Olares 模型控制台安装语音识别应用",
+  "settings.model.title": "语音模型",
+  "settings.model.hint": "留空则自动选择目录中的语音模型",
+  "settings.model.auto": "自动选择",
+  "settings.language.title": "识别语言",
+  "settings.language.hint": "指定语言可提升准确度与速度",
+  "settings.saveFailed": "保存失败",
+};
+
+export const EN = {
+  "error.voice_permission_denied": "Microphone access denied",
+  "error.voice_audio_too_large": "Recording too long",
+  "error.voice_audio_unreadable": "Audio unreadable, please re-record",
+  "error.voice_model_unavailable":
+    "Voice model unavailable; install a speech-recognition app in the Olares Model Console first",
+  "error.voice_timeout": "Transcription timed out, please retry",
+  "error.voice_too_short": "Recording too short",
+  "error.voice_no_input": "No voice detected",
+  "error.voice_failed": "Transcription failed, please retry",
+  "error.voice_unsupported": "This browser does not support recording",
+  "mic.stop": "Click to stop recording",
+  "mic.transcribing": "Transcribing…",
+  "mic.idle": "Voice input",
+  "mic.blocked": "Input unavailable",
+  "lang.auto": "Auto-detect",
+  "status.auto": "auto",
+  "settings.title": "Voice input",
+  "settings.intro":
+    "Click the microphone beside the composer to record; the take is transcribed and inserted automatically. Transcription is served by an Olares Router voice model.",
+  "settings.refresh": "Refresh",
+  "settings.refreshing": "Refreshing…",
+  "settings.router": "Router console",
+  "settings.loading": "Loading voice input settings…",
+  "settings.loadFailed": "Failed to load voice input settings",
+  "settings.refreshFailed": "Failed to refresh voice models",
+  "settings.status.ready": "Voice ready · model {model}",
+  "settings.status.notReady":
+    "Voice model not available yet; install a speech-recognition app in the Olares Model Console first",
+  "settings.model.title": "Voice model",
+  "settings.model.hint": "Leave empty to auto-pick a voice model from the catalog",
+  "settings.model.auto": "Auto",
+  "settings.language.title": "Recognition language",
+  "settings.language.hint": "Specifying a language improves accuracy and speed",
+  "settings.saveFailed": "Failed to save",
+};

package/icons/mark.js

@@ -0,0 +1,22 @@
+import { PRODUCT_NAME } from "../brand/identity.js";
+
+/**
+ * Product mark: favicon, PWA icon, CSS splash, and slot occupants.
+ * An eave over a resident orb — two strokes, readable at 20px collapsed rail.
+ */
+export const MARK_PATH = "/lares/mark.svg";
+
+export const MARK_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-label="${PRODUCT_NAME}">
+  <defs>
+    <linearGradient id="lares-mark" x1="0" y1="0" x2="32" y2="32" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#6366F1"/>
+      <stop offset="1" stop-color="#22D3EE"/>
+    </linearGradient>
+  </defs>
+  <rect width="32" height="32" rx="8" fill="url(#lares-mark)"/>
+  <path fill="none" stroke="#fff" stroke-width="3.2" stroke-linecap="round" stroke-linejoin="round" d="M6.8 17.4 16 9.2l9.2 8.2"/>
+  <circle cx="16" cy="22" r="3.2" fill="#fff"/>
+</svg>`;
+
+/** Inline form for CSS `background-image`, which cannot reference a route that may 404 mid-boot. */
+export const MARK_DATA_URI = `url("data:image/svg+xml,${encodeURIComponent(MARK_SVG)}")`;

package/larepass/chat.js

@@ -0,0 +1,134 @@
+import { isAuthFailure } from "./host.js";
+import { consumeMux, MUX_PATH } from "./mux.js";
+import { foldTranscript, mergeEvents } from "./transcript.js";
+import { promptPayload, rpcPath, unwrapServerResponse, wrapClientRequest } from "./rpc.js";
+
+function httpStatus(res) {
+  return Number(res?.status) || 0;
+}
+
+function asError(code, message, extra = {}) {
+  return { ok: false, error: { code, message }, ...extra };
+}
+
+export async function callRpc(request, method, payload = {}) {
+  const envelope = wrapClientRequest(method, payload);
+  let res;
+  try {
+    res = await request(rpcPath(method), { method: "POST", body: envelope });
+  } catch (err) {
+    return asError("unreachable", err instanceof Error ? err.message : String(err), { status: "unreachable" });
+  }
+  const http = httpStatus(res);
+  if (isAuthFailure(http)) {
+    return asError("unauthorized", `Host rejected this login (${http})`, { status: "unauthorized", http });
+  }
+  if (http < 200 || http >= 300) {
+    return asError("http", `Host returned ${http}`, { status: "error", http });
+  }
+  const parsed = unwrapServerResponse(res.body);
+  if (!parsed.ok) return { ...parsed, status: "rpc-error", http };
+  return { ...parsed, status: "ok", http };
+}
+
+export async function listRootSessions(rpc) {
+  const listed = await rpc("session.list", {});
+  if (!listed.ok) return listed;
+  return {
+    ok: true,
+    status: listed.status || "ok",
+    value: { items: rootSessions(listed.value?.items).map(summarizeSession) },
+  };
+}
+
+export async function ensureSession(rpc) {
+  const listed = await listRootSessions(rpc);
+  if (!listed.ok) return listed;
+  const existing = listed.value.items[0];
+  if (existing) {
+    return { ok: true, status: "ok", value: { sessionId: existing.sessionId, sessions: listed.value.items } };
+  }
+  const created = await rpc("session.create", {});
+  if (!created.ok) return created;
+  const row = summarizeSession({ ...created.value, sessionId: created.value.sessionId });
+  return { ok: true, status: "ok", value: { sessionId: row.sessionId, sessions: [row] } };
+}
+
+export function rootSessions(items) {
+  return (Array.isArray(items) ? items : []).filter(
+    (row) => row?.sessionId && !row.parentSessionId && row.origin !== "subagent",
+  );
+}
+
+function basenameCwd(cwd) {
+  if (!cwd) return "";
+  const base = String(cwd).replace(/[/\\]+$/, "").split(/[/\\]/).pop();
+  return base && base !== "." ? base : "";
+}
+
+export function sessionTitleOf(row) {
+  const projected = row?.projections?.values?.title;
+  if (typeof projected === "string" && projected.trim()) return projected.trim();
+  if (typeof row?.title === "string" && row.title.trim()) return row.title.trim();
+  if (typeof row?.name === "string" && row.name.trim()) return row.name.trim();
+  return basenameCwd(row?.cwd);
+}
+
+export function summarizeSession(row) {
+  return {
+    sessionId: row.sessionId,
+    title: sessionTitleOf(row),
+    updatedAt: Number(row.updatedAt || row.mtime || row.createdAt || 0) || 0,
+    blank: Boolean(row.blank),
+  };
+}
+
+export function visibleHistorySessions(sessions, currentId) {
+  return (Array.isArray(sessions) ? sessions : []).filter(
+    (row) => row?.sessionId && (!row.blank || row.sessionId === currentId),
+  );
+}
+
+function startOfLocalDay(ms) {
+  const date = new Date(ms);
+  date.setHours(0, 0, 0, 0);
+  return date.getTime();
+}
+
+export function groupSessionsByRecency(sessions, now = Date.now()) {
+  const today = startOfLocalDay(now);
+  const week = today - 7 * 24 * 60 * 60 * 1000;
+  const buckets = { today: [], week: [], older: [] };
+  const sorted = [...sessions].sort((left, right) => (right.updatedAt || 0) - (left.updatedAt || 0));
+  for (const row of sorted) {
+    const at = Number(row.updatedAt) || 0;
+    if (at >= today) buckets.today.push(row);
+    else if (at >= week) buckets.week.push(row);
+    else buckets.older.push(row);
+  }
+  return [
+    { id: "today", key: "history.today", rows: buckets.today },
+    { id: "week", key: "history.week", rows: buckets.week },
+    { id: "older", key: "history.older", rows: buckets.older },
+  ].filter((section) => section.rows.length > 0);
+}
+
+export async function loadTranscript(rpc, sessionId) {
+  const history = await rpc("session.history", { sessionId });
+  if (!history.ok) return history;
+  return { ok: true, status: "ok", value: foldTranscript(history.value?.events) };
+}
+
+export function clientTimeZone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    return "";
+  }
+}
+
+export function sendPrompt(rpc, sessionId, text) {
+  return rpc("session.prompt", promptPayload(sessionId, text, clientTimeZone()));
+}
+
+export { consumeMux, mergeEvents, MUX_PATH };

package/larepass/context-provenance.js

@@ -0,0 +1,65 @@
+/** Same projection as dsh-client-runtime `contextProvenance` / `contextForm`. */
+
+const KNOWN_FORMS = ["instructions", "catalog", "snapshot", "notice", "relay", "recall"];
+
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+
+function readString(record, key) {
+  const value = record[key];
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+
+function collect(source, member, field) {
+  const list = source[member];
+  if (!Array.isArray(list)) return [];
+  const seen = [];
+  for (const entry of list) {
+    const record = asRecord(entry);
+    const value = record === null ? null : readString(record, field);
+    if (value !== null && !seen.includes(value)) seen.push(value);
+  }
+  return seen;
+}
+
+function joined(names) {
+  return names.length > 0 ? names.join(", ") : null;
+}
+
+export function sessionRecallLabels(source) {
+  const record = asRecord(source);
+  if (record === null || readString(record, "kind") !== "session-reference") return [];
+  return collect(record, "references", "label");
+}
+
+export function contextProvenance(source) {
+  const record = asRecord(source);
+  const kind = record === null ? null : readString(record, "kind");
+  if (record === null || kind === null) {
+    return { role: "inject", label: null };
+  }
+  switch (kind) {
+    case "session-reference":
+      return { role: "recall", label: joined(collect(record, "references", "label")) ?? kind };
+    case "agent-instructions":
+      return { role: "inject", label: joined(collect(record, "changes", "path")) ?? kind };
+    case "plugin":
+      return { role: "inject", label: readString(record, "plugin") ?? kind };
+    case "skill-invocation":
+      return { role: "inject", label: readString(record, "name") ?? kind };
+    default:
+      return { role: "inject", label: kind };
+  }
+}
+
+export function contextForm(source) {
+  const record = asRecord(source);
+  const form = record === null ? null : readString(record, "form");
+  return form !== null && KNOWN_FORMS.includes(form) ? form : null;
+}
+
+export function isHumanUserSource(source) {
+  const kind = asRecord(source) === null ? null : readString(asRecord(source), "kind");
+  return kind === null || kind === "user";
+}

package/larepass/host.js

@@ -0,0 +1,80 @@
+export const APP_ID = "lares";
+export const LARES_API_PREFIX = "/api/lares";
+export const MODELS_PATH = `${LARES_API_PREFIX}/models`;
+export const PC_TEST_PROXY = "/laresHost";
+
+/** Host plugin routes (`file-preview`, models, voice, …). Same path on PC and LarePass. */
+export function isLaresPluginPath(path) {
+  const suffix = String(path ?? "").startsWith("/") ? path : `/${path}`;
+  return suffix === LARES_API_PREFIX
+    || suffix.startsWith(`${LARES_API_PREFIX}/`)
+    || suffix.startsWith(`${LARES_API_PREFIX}?`);
+}
+
+export function originOf(url) {
+  if (!url) return "";
+  try {
+    return new URL(String(url)).origin;
+  } catch {
+    return "";
+  }
+}
+
+export function findLaresEntrance(apps) {
+  const list = Array.isArray(apps) ? apps : [];
+  const hit = list.find((app) => app?.appid === APP_ID || app?.id === APP_ID);
+  return originOf(hit?.url);
+}
+
+export function entranceFromDomain({ protocol = "https:", subdomain, accountDomain }) {
+  const host = String(subdomain ?? "").trim();
+  const domain = String(accountDomain ?? "").trim();
+  if (!host || !domain) return "";
+  const scheme = String(protocol).replace(/:\/?\/?$/, "");
+  return `${scheme}://${host}.${domain}`;
+}
+
+export function hostConfigFromEnv(env = {}) {
+  return {
+    baseUrl: entranceFromDomain({
+      protocol: env.PROTOCOL,
+      subdomain: env.LARES_SUB_DOMAIN,
+      accountDomain: env.ACCOUNT_DOMAIN,
+    }),
+    proxyPrefix: env.IS_PC_TEST ? PC_TEST_PROXY : "",
+  };
+}
+
+export function hostUrl({ baseUrl = "", proxyPrefix = "", path }) {
+  const suffix = path.startsWith("/") ? path : `/${path}`;
+  if (proxyPrefix) {
+    // Plugin routes are same-origin Host URLs. Prefixing them with /laresHost
+    // would make the same conversation emit different img/src on LarePass vs PC.
+    // RPC (`/api/session.list`) still needs the proxy: `/api` is Files.
+    if (isLaresPluginPath(suffix)) return suffix;
+    return `${proxyPrefix.replace(/\/$/, "")}${suffix}`;
+  }
+  const origin = String(baseUrl).replace(/\/$/, "");
+  return origin ? `${origin}${suffix}` : suffix;
+}
+
+export function isAuthFailure(http) {
+  return http === 401 || http === 403 || http === 301 || http === 302 || http === 303 || http === 307 || http === 308;
+}
+
+export async function probeHost(request, path = MODELS_PATH) {
+  try {
+    const res = await request(path);
+    const http = Number(res?.status) || 0;
+    if (isAuthFailure(http)) {
+      return { status: "unauthorized", http };
+    }
+    if (http >= 200 && http < 300) return { status: "ok", http, body: res.body };
+    return { status: "error", http };
+  } catch (err) {
+    return {
+      status: "unreachable",
+      error: err instanceof Error ? err.message : String(err),
+    };
+  }
+}