@dipertq/dsh-openviking-status 0.1.8 → 0.2.0

package/lib/client.js

@@ -13,6 +13,7 @@ import React2, {
   useRef as useRef2,
   useMemo
 } from "react";
+import ReactDOM from "react-dom";
 
 // src/client/api.ts
 var DEFAULT_OPENVIKING_ENDPOINT = "http://127.0.0.1:1933";
@@ -66,6 +67,30 @@ var OpenVikingClient = class {
     this.endpoint = resolveEndpoint(endpoint);
     this.apiKey = resolveApiKey(apiKey);
   }
+  /**
+   * Обновление конфигурации клиента на лету (например, после сохранения настроек в UI).
+   */
+  updateConfig(config) {
+    if (config.endpoint && config.endpoint.trim()) {
+      this.endpoint = resolveEndpoint(config.endpoint);
+    }
+    if (config.apiKey !== void 0) {
+      this.apiKey = resolveApiKey(config.apiKey);
+    }
+    this.resolvedSessionIds.clear();
+  }
+  /**
+   * Очистить кэш разрешенных идентификаторов сессий.
+   */
+  clearResolvedSessions() {
+    this.resolvedSessionIds.clear();
+  }
+  /**
+   * Проверка, работает ли клиент через DSH Web Server proxy.
+   */
+  isProxy() {
+    return this.endpoint.startsWith("/") || this.endpoint.includes("/openviking-status/api");
+  }
   /**
    * Формирование заголовков запроса, включая опциональный заголовок авторизации
    */
@@ -107,6 +132,32 @@ var OpenVikingClient = class {
    * Проверка доступности и состояния сервиса OpenViking
    */
   async checkHealth() {
+    if (this.isProxy()) {
+      try {
+        const res = await fetch(`${this.endpoint}/health`, {
+          method: "GET",
+          headers: this.getHeaders()
+        });
+        if (!res.ok) {
+          return {
+            ok: false,
+            error: `HTTP ${res.status}: ${res.statusText}`
+          };
+        }
+        const body = await res.json().catch(() => ({}));
+        const isOk = body.ok !== false && body.status !== "error" && (body.ok === true || body.status === "ok" || body.status === "healthy" || res.ok);
+        return {
+          ok: isOk,
+          version: typeof body.version === "string" ? body.version : void 0,
+          storage: typeof body.storage === "string" ? body.storage : void 0
+        };
+      } catch (err) {
+        return {
+          ok: false,
+          error: err instanceof Error ? err.message : String(err)
+        };
+      }
+    }
     try {
       const res = await fetch(`${this.endpoint}/health`, {
         method: "GET",
@@ -144,6 +195,48 @@ var OpenVikingClient = class {
     if (!sessionId || !sessionId.trim()) {
       return { status: "missing" };
     }
+    if (this.isProxy()) {
+      try {
+        const res = await fetch(
+          `${this.endpoint}/session?id=${encodeURIComponent(sessionId.trim())}`,
+          {
+            method: "GET",
+            headers: this.getHeaders()
+          }
+        );
+        if (res.status === 401 || res.status === 403) {
+          return { status: "unauthorized" };
+        }
+        if (!res.ok) {
+          return { status: "error", detail: `HTTP ${res.status}` };
+        }
+        const data = await res.json();
+        if (data.status === "unauthorized") return { status: "unauthorized" };
+        if (data.status === "missing") return { status: "missing" };
+        if (data.status === "unreachable")
+          return {
+            status: "unreachable",
+            detail: typeof data.detail === "string" ? data.detail : void 0
+          };
+        if (data.status === "error")
+          return {
+            status: "error",
+            detail: typeof data.detail === "string" ? data.detail : void 0
+          };
+        if (data.status === "ok" && data.session) {
+          return {
+            status: "ok",
+            session: data.session
+          };
+        }
+        return { status: "error", detail: "malformed response from proxy" };
+      } catch (err) {
+        return {
+          status: "unreachable",
+          detail: err instanceof Error ? err.message : String(err)
+        };
+      }
+    }
     const candidates = this.getCandidateSessionIds(sessionId);
     for (const candidateId of candidates) {
       try {
@@ -213,6 +306,31 @@ var OpenVikingClient = class {
     if (!sessionId || !sessionId.trim()) {
       return { ok: false, error: "Missing sessionId" };
     }
+    if (this.isProxy()) {
+      try {
+        const res = await fetch(`${this.endpoint}/session/commit`, {
+          method: "POST",
+          headers: this.getHeaders(),
+          body: JSON.stringify({
+            sessionId: sessionId.trim(),
+            ...options ?? { keep_recent_count: 10 }
+          })
+        });
+        if (!res.ok) {
+          return { ok: false, error: `HTTP ${res.status}` };
+        }
+        const data = await res.json().catch(() => ({}));
+        return {
+          ok: data.ok === true,
+          error: typeof data.error === "string" ? data.error : void 0
+        };
+      } catch (err) {
+        return {
+          ok: false,
+          error: err instanceof Error ? err.message : String(err)
+        };
+      }
+    }
     const candidates = this.getCandidateSessionIds(sessionId);
     const bodyPayload = JSON.stringify(options ?? { keep_recent_count: 10 });
     let lastError = "Session commit failed";
@@ -292,6 +410,10 @@ var THEME = {
   stateWarning: "--dsw-alias-state-warn-primary",
   /** Утопленная поверхность: дорожка прогресс-бара. */
   insetSurface: "--dsw-alias-bg-layer-2",
+  /** Заливка основной кнопки действий. */
+  buttonPrimaryFill: "--dsw-alias-button-primary-fill",
+  /** Цвет текста на основной кнопке действий. */
+  buttonPrimaryText: "--dsw-alias-label-primary-inverted",
   /** Моноширинный шрифт для идентификаторов и путей. */
   fontMono: "--dsw-font-markdown-code-font-family"
 };
@@ -1225,8 +1347,22 @@ function StatusChipView({
   const [isCommitting, setIsCommitting] = useState2(false);
   const [commitError, setCommitError] = useState2(null);
   const [isHovered, setIsHovered] = useState2(false);
+  const [statsHost, setStatsHost] = useState2(null);
   const popoverRef = useRef2(null);
   const apiClient = client ?? defaultOpenVikingClient;
+  useEffect2(() => {
+    if (typeof document === "undefined") return;
+    function findHost() {
+      const el = document.querySelector("[data-composer-stats]");
+      setStatsHost((prev) => prev !== el ? el : prev);
+    }
+    findHost();
+    const observer = new MutationObserver(() => {
+      findHost();
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    return () => observer.disconnect();
+  }, []);
   const conversationText = useMemo(() => {
     if (typeof contextText === "string") return contextText;
     return chatNodesToText(messages);
@@ -1312,10 +1448,11 @@ function StatusChipView({
     sessionUnreadable
   });
   const label = !isOnline ? "OV offline" : sessionUnreadable ? `OV: ${recalledCount} rec \xB7 no access` : `OV: ${recalledCount} rec \xB7 ${Math.round(pendingTokens / 1e3)}k pend`;
-  return /* @__PURE__ */ jsxs2(
+  const chipElement = /* @__PURE__ */ jsxs2(
     "span",
     {
       className,
+      "data-openviking-status": "true",
       style: { minWidth: 0, display: "inline-flex", position: "relative" },
       ref: popoverRef,
       children: [
@@ -1329,14 +1466,13 @@ function StatusChipView({
             "aria-expanded": isOpen,
             "aria-haspopup": "dialog",
             style: {
-              // Геометрия и типографика повторяют штатный чип статистики DSH:
-              // прозрачный фон, без рамки, шрифт и кегль наследуются от строки.
               boxSizing: "border-box",
               maxWidth: "100%",
-              color: themeVar("labelTertiary"),
-              font: "inherit",
+              color: isHovered ? themeVar("labelSecondary") : themeVar("labelTertiary"),
+              fontFamily: "var(--dsw-font-family, system-ui)",
+              fontSize: "var(--dsh-content-font-size-secondary, 13px)",
+              lineHeight: "calc(20px + var(--dsh-content-font-delta-secondary, 0px))",
               fontVariantNumeric: "tabular-nums",
-              lineHeight: "inherit",
               whiteSpace: "nowrap",
               background: isHovered ? themeVar("hoverBackground") : "transparent",
               border: "none",
@@ -1386,6 +1522,572 @@ function StatusChipView({
       ]
     }
   );
+  if (statsHost && typeof document !== "undefined") {
+    return ReactDOM.createPortal(chipElement, statsHost);
+  }
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      style: {
+        maxWidth: "var(--dsh-chat-content-width, 748px)",
+        boxSizing: "border-box",
+        width: "100%",
+        padding: "4px calc(var(--dsh-composer-side-clearance, 0px) + 16px) 0px",
+        fontSize: "var(--dsh-content-font-size-secondary, 13px)",
+        lineHeight: "calc(20px + var(--dsh-content-font-delta-secondary, 0px))",
+        justifyContent: "center",
+        gap: "12px",
+        margin: "0 auto",
+        display: "flex"
+      },
+      children: chipElement
+    }
+  );
+}
+
+// src/client/OpenVikingSettingsSection.tsx
+import { useState as useState3, useEffect as useEffect3 } from "react";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var API_CONFIG = "/openviking-status/api/config";
+var API_TEST = "/openviking-status/api/test-connection";
+var SOURCE_LABELS = {
+  ovcli: "Auto-detected from ~/.openviking/ovcli.conf",
+  env: "Auto-detected from environment variables",
+  ov: "Auto-detected from ~/.openviking/ov.conf",
+  settings: "Custom override in DSH settings.yaml",
+  default: "Default local configuration"
+};
+function OpenVikingSettingsSection({
+  initialConfig,
+  onConfigSaved,
+  className,
+  style
+}) {
+  const [endpoint, setEndpoint] = useState3(
+    initialConfig?.endpoint || "http://127.0.0.1:1933"
+  );
+  const [apiKey, setApiKey] = useState3("");
+  const [showKey, setShowKey] = useState3(false);
+  const [source, setSource] = useState3(
+    initialConfig?.source || "default"
+  );
+  const [hasStoredKey, setHasStoredKey] = useState3(
+    initialConfig?.hasApiKey || false
+  );
+  const [loading, setLoading] = useState3(!initialConfig);
+  const [testing, setTesting] = useState3(false);
+  const [saving, setSaving] = useState3(false);
+  const [testResult, setTestResult] = useState3(null);
+  const [flash, setFlash] = useState3(null);
+  useEffect3(() => {
+    if (initialConfig) return;
+    let active = true;
+    async function fetchConfig() {
+      try {
+        setLoading(true);
+        const res = await fetch(API_CONFIG, { cache: "no-store" });
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        const data = await res.json();
+        if (!active) return;
+        const newEp = data.endpoint || "http://127.0.0.1:1933";
+        setEndpoint(newEp);
+        setSource(data.source || "default");
+        setHasStoredKey(data.hasApiKey);
+        defaultOpenVikingClient.clearResolvedSessions();
+      } catch {
+      } finally {
+        if (active) setLoading(false);
+      }
+    }
+    void fetchConfig();
+    return () => {
+      active = false;
+    };
+  }, [initialConfig]);
+  async function handleTestConnection() {
+    setTesting(true);
+    setTestResult(null);
+    setFlash(null);
+    try {
+      const res = await fetch(API_TEST, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          endpoint: endpoint.trim(),
+          apiKey: apiKey.trim() || void 0
+        })
+      });
+      const data = await res.json();
+      setTestResult(data);
+    } catch (err) {
+      setTestResult({
+        ok: false,
+        authenticated: false,
+        error: String(err instanceof Error ? err.message : err)
+      });
+    } finally {
+      setTesting(false);
+    }
+  }
+  async function handleSave() {
+    setSaving(true);
+    setFlash(null);
+    try {
+      const res = await fetch(API_CONFIG, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          endpoint: endpoint.trim(),
+          apiKey: apiKey.trim() || void 0
+        })
+      });
+      const data = await res.json();
+      if (!res.ok || data.error) {
+        throw new Error(data.error || `HTTP ${res.status}`);
+      }
+      setFlash({ kind: "ok", message: "Settings saved successfully" });
+      setSource("settings");
+      defaultOpenVikingClient.clearResolvedSessions();
+      if (apiKey.trim()) {
+        setHasStoredKey(true);
+        setApiKey("");
+      }
+      onConfigSaved?.(
+        data.config || {
+          endpoint,
+          hasApiKey: hasStoredKey || Boolean(apiKey.trim()),
+          source: "settings"
+        }
+      );
+    } catch (err) {
+      setFlash({
+        kind: "err",
+        message: `Failed to save: ${err instanceof Error ? err.message : String(err)}`
+      });
+    } finally {
+      setSaving(false);
+    }
+  }
+  async function handleReset() {
+    setSaving(true);
+    setFlash(null);
+    setTestResult(null);
+    try {
+      const res = await fetch(API_CONFIG, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ reset: true })
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const cfgRes = await fetch(API_CONFIG, { cache: "no-store" });
+      if (cfgRes.ok) {
+        const data = await cfgRes.json();
+        const newEp = data.endpoint || "http://127.0.0.1:1933";
+        setEndpoint(newEp);
+        setSource(data.source || "default");
+        setHasStoredKey(data.hasApiKey);
+        setApiKey("");
+        defaultOpenVikingClient.clearResolvedSessions();
+        setFlash({
+          kind: "ok",
+          message: "Reset to auto-detected local settings"
+        });
+        onConfigSaved?.(data);
+      }
+    } catch (err) {
+      setFlash({
+        kind: "err",
+        message: `Failed to reset: ${err instanceof Error ? err.message : String(err)}`
+      });
+    } finally {
+      setSaving(false);
+    }
+  }
+  const sourceBadgeText = SOURCE_LABELS[source] || SOURCE_LABELS["default"];
+  return /* @__PURE__ */ jsxs3(
+    "div",
+    {
+      className: `ov-settings-root ${className || ""}`,
+      style: {
+        display: "flex",
+        flexDirection: "column",
+        gap: 20,
+        maxWidth: 720,
+        padding: "24px 28px",
+        color: themeVar("labelPrimary"),
+        fontSize: 14,
+        lineHeight: 1.6,
+        ...style
+      },
+      children: [
+        /* @__PURE__ */ jsxs3("div", { children: [
+          /* @__PURE__ */ jsxs3(
+            "div",
+            {
+              style: {
+                display: "flex",
+                alignItems: "baseline",
+                gap: 12,
+                marginBottom: 6
+              },
+              children: [
+                /* @__PURE__ */ jsx3(
+                  "h2",
+                  {
+                    style: {
+                      fontSize: 20,
+                      fontWeight: 600,
+                      margin: 0,
+                      color: themeVar("labelPrimary")
+                    },
+                    children: "OpenViking Status"
+                  }
+                ),
+                /* @__PURE__ */ jsx3(
+                  "span",
+                  {
+                    style: {
+                      fontSize: 12,
+                      fontWeight: 500,
+                      padding: "2px 8px",
+                      borderRadius: 6,
+                      background: themeVar("insetSurface"),
+                      border: `1px solid ${themeVar("hairline")}`,
+                      color: themeVar("labelSecondary")
+                    },
+                    children: sourceBadgeText
+                  }
+                )
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsx3(
+            "p",
+            {
+              style: { margin: 0, color: themeVar("labelSecondary"), fontSize: 13 },
+              children: "Configure connection credentials for monitoring OpenViking persistent memory and session status."
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsxs3(
+          "div",
+          {
+            style: {
+              border: `1px solid ${themeVar("hairline")}`,
+              borderRadius: 12,
+              padding: 20,
+              background: themeVar("insetSurface"),
+              display: "flex",
+              flexDirection: "column",
+              gap: 16
+            },
+            children: [
+              /* @__PURE__ */ jsxs3("div", { children: [
+                /* @__PURE__ */ jsx3(
+                  "label",
+                  {
+                    style: {
+                      display: "block",
+                      fontSize: 13,
+                      fontWeight: 600,
+                      marginBottom: 6,
+                      color: themeVar("labelPrimary")
+                    },
+                    children: "Daemon Endpoint"
+                  }
+                ),
+                /* @__PURE__ */ jsx3(
+                  "input",
+                  {
+                    type: "text",
+                    value: endpoint,
+                    onChange: (e) => setEndpoint(e.target.value),
+                    placeholder: "http://127.0.0.1:1933",
+                    style: {
+                      width: "100%",
+                      boxSizing: "border-box",
+                      padding: "9px 12px",
+                      fontSize: 14,
+                      fontFamily: themeVar("fontMono"),
+                      borderRadius: 8,
+                      border: `1px solid ${themeVar("hairline")}`,
+                      background: themeVar("panelSurface"),
+                      color: themeVar("labelPrimary"),
+                      outline: "none"
+                    }
+                  }
+                ),
+                /* @__PURE__ */ jsx3(
+                  "span",
+                  {
+                    style: {
+                      fontSize: 12,
+                      color: themeVar("labelTertiary"),
+                      marginTop: 4,
+                      display: "block"
+                    },
+                    children: "The URL of the local or remote OpenViking HTTP server. Resolved from the DSH host."
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsxs3("div", { children: [
+                /* @__PURE__ */ jsxs3(
+                  "div",
+                  {
+                    style: {
+                      display: "flex",
+                      justifyContent: "space-between",
+                      alignItems: "center",
+                      marginBottom: 6
+                    },
+                    children: [
+                      /* @__PURE__ */ jsx3(
+                        "label",
+                        {
+                          style: {
+                            fontSize: 13,
+                            fontWeight: 600,
+                            color: themeVar("labelPrimary")
+                          },
+                          children: "API Token (Authentication)"
+                        }
+                      ),
+                      hasStoredKey && !apiKey && /* @__PURE__ */ jsx3(
+                        "span",
+                        {
+                          style: {
+                            fontSize: 12,
+                            color: themeVar("stateSuccess"),
+                            fontWeight: 500
+                          },
+                          children: "\u25CF Active token configured"
+                        }
+                      )
+                    ]
+                  }
+                ),
+                /* @__PURE__ */ jsxs3("div", { style: { display: "flex", gap: 8 }, children: [
+                  /* @__PURE__ */ jsx3(
+                    "input",
+                    {
+                      type: showKey ? "text" : "password",
+                      value: apiKey,
+                      onChange: (e) => setApiKey(e.target.value),
+                      placeholder: hasStoredKey ? "(Token stored \u2014 leave blank to keep unchanged)" : "Optional or required if daemon uses auth_mode: api_key",
+                      style: {
+                        flex: 1,
+                        padding: "9px 12px",
+                        fontSize: 14,
+                        fontFamily: themeVar("fontMono"),
+                        borderRadius: 8,
+                        border: `1px solid ${themeVar("hairline")}`,
+                        background: themeVar("panelSurface"),
+                        color: themeVar("labelPrimary"),
+                        outline: "none"
+                      }
+                    }
+                  ),
+                  /* @__PURE__ */ jsx3(
+                    "button",
+                    {
+                      type: "button",
+                      onClick: () => setShowKey((v) => !v),
+                      style: {
+                        padding: "0 14px",
+                        fontSize: 13,
+                        fontWeight: 500,
+                        borderRadius: 8,
+                        border: `1px solid ${themeVar("hairline")}`,
+                        background: themeVar("panelSurface"),
+                        color: themeVar("labelSecondary"),
+                        cursor: "pointer"
+                      },
+                      children: showKey ? "Hide" : "Show"
+                    }
+                  )
+                ] }),
+                /* @__PURE__ */ jsx3(
+                  "span",
+                  {
+                    style: {
+                      fontSize: 12,
+                      color: themeVar("labelTertiary"),
+                      marginTop: 4,
+                      display: "block"
+                    },
+                    children: "Required when the daemon runs with auth_mode: api_key. Local tokens are typically found in ~/.openviking/ovcli.conf."
+                  }
+                )
+              ] }),
+              testResult && /* @__PURE__ */ jsxs3(
+                "div",
+                {
+                  style: {
+                    padding: "10px 14px",
+                    borderRadius: 8,
+                    fontSize: 13,
+                    display: "flex",
+                    alignItems: "center",
+                    gap: 8,
+                    border: `1px solid ${testResult.ok && testResult.authenticated ? themeVar("stateSuccess") : themeVar("stateError")}`,
+                    background: themeVar("panelSurface"),
+                    color: testResult.ok && testResult.authenticated ? themeVar("stateSuccess") : themeVar("stateError")
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx3("span", { children: testResult.ok && testResult.authenticated ? "\u25CF" : "\u2715" }),
+                    /* @__PURE__ */ jsx3("div", { style: { flex: 1 }, children: testResult.ok && testResult.authenticated ? /* @__PURE__ */ jsxs3("div", { children: [
+                      /* @__PURE__ */ jsx3("strong", { children: "Connected successfully" }),
+                      testResult.version && /* @__PURE__ */ jsxs3("span", { children: [
+                        " \xB7 ",
+                        testResult.version
+                      ] }),
+                      testResult.storage && /* @__PURE__ */ jsxs3("span", { children: [
+                        " (storage: ",
+                        testResult.storage,
+                        ")"
+                      ] })
+                    ] }) : /* @__PURE__ */ jsxs3("div", { children: [
+                      /* @__PURE__ */ jsx3("strong", { children: "Connection failed: " }),
+                      /* @__PURE__ */ jsx3("span", { children: testResult.error || "Unable to reach daemon or token unauthorized" })
+                    ] }) })
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsxs3(
+                "div",
+                {
+                  style: {
+                    display: "flex",
+                    flexWrap: "wrap",
+                    alignItems: "center",
+                    gap: 10,
+                    paddingTop: 4
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx3(
+                      "button",
+                      {
+                        type: "button",
+                        disabled: testing || loading,
+                        onClick: () => void handleTestConnection(),
+                        style: {
+                          padding: "8px 16px",
+                          fontSize: 13,
+                          fontWeight: 500,
+                          borderRadius: 8,
+                          border: `1px solid ${themeVar("hairline")}`,
+                          background: themeVar("panelSurface"),
+                          color: themeVar("labelPrimary"),
+                          cursor: testing ? "not-allowed" : "pointer",
+                          opacity: testing ? 0.6 : 1
+                        },
+                        children: testing ? "Testing..." : "Test Connection"
+                      }
+                    ),
+                    /* @__PURE__ */ jsx3(
+                      "button",
+                      {
+                        type: "button",
+                        disabled: saving || loading,
+                        onClick: () => void handleSave(),
+                        style: {
+                          padding: "8px 18px",
+                          fontSize: 13,
+                          fontWeight: 600,
+                          borderRadius: 8,
+                          border: "none",
+                          background: themeVar("buttonPrimaryFill"),
+                          color: themeVar("buttonPrimaryText"),
+                          cursor: saving ? "not-allowed" : "pointer",
+                          opacity: saving ? 0.6 : 1
+                        },
+                        children: saving ? "Saving..." : "Save Settings"
+                      }
+                    ),
+                    source === "settings" && /* @__PURE__ */ jsx3(
+                      "button",
+                      {
+                        type: "button",
+                        disabled: saving || loading,
+                        onClick: () => void handleReset(),
+                        style: {
+                          padding: "8px 14px",
+                          fontSize: 13,
+                          fontWeight: 500,
+                          borderRadius: 8,
+                          border: `1px solid ${themeVar("hairline")}`,
+                          background: "transparent",
+                          color: themeVar("labelSecondary"),
+                          cursor: "pointer",
+                          marginLeft: "auto"
+                        },
+                        children: "Reset to Auto-detected"
+                      }
+                    ),
+                    flash && /* @__PURE__ */ jsx3(
+                      "span",
+                      {
+                        style: {
+                          fontSize: 13,
+                          color: flash.kind === "ok" ? themeVar("stateSuccess") : themeVar("stateError"),
+                          fontWeight: 500
+                        },
+                        children: flash.message
+                      }
+                    )
+                  ]
+                }
+              )
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs3(
+          "div",
+          {
+            style: {
+              border: `1px solid ${themeVar("hairline")}`,
+              borderRadius: 10,
+              padding: "14px 18px",
+              background: themeVar("panelSurface"),
+              fontSize: 13,
+              color: themeVar("labelSecondary"),
+              lineHeight: 1.5
+            },
+            children: [
+              /* @__PURE__ */ jsx3(
+                "p",
+                {
+                  style: {
+                    margin: "0 0 6px 0",
+                    fontWeight: 600,
+                    color: themeVar("labelPrimary")
+                  },
+                  children: "How OpenViking connection works:"
+                }
+              ),
+              /* @__PURE__ */ jsxs3("ul", { style: { margin: 0, paddingLeft: 18 }, children: [
+                /* @__PURE__ */ jsx3("li", { style: { marginBottom: 4 }, children: "All requests to OpenViking proxy through the DSH Desktop host, making it work seamlessly even when managing DSH remotely over Tailscale, mobile, or LAN." }),
+                /* @__PURE__ */ jsxs3("li", { style: { marginBottom: 4 }, children: [
+                  "If OpenViking runs locally on the standard port (1933), the plugin auto-detects credentials from ",
+                  /* @__PURE__ */ jsx3("code", { children: "~/.openviking/ovcli.conf" }),
+                  "."
+                ] }),
+                /* @__PURE__ */ jsxs3("li", { children: [
+                  "Custom values saved here are persisted in",
+                  " ",
+                  /* @__PURE__ */ jsx3("code", { children: "~/.dsh/settings.yaml" }),
+                  " under the",
+                  " ",
+                  /* @__PURE__ */ jsx3("code", { children: "openviking-status" }),
+                  " namespace."
+                ] })
+              ] })
+            ]
+          }
+        )
+      ]
+    }
+  );
 }
 
 // src/client/index.tsx
@@ -1407,11 +2109,27 @@ function apply(ctx) {
     ),
     "openviking-status: composer stats chip"
   );
+  ctx.effect(
+    () => ctx.slots.inject(
+      "settings.section",
+      () => ctx.slots.register(
+        {
+          name: "settings.section",
+          id: "openviking-status",
+          order: 35,
+          label: () => "OpenViking"
+        },
+        OpenVikingSettingsSection
+      )
+    ),
+    "openviking-status: settings section"
+  );
 }
 export {
   COMMIT_THRESHOLD,
   DEFAULT_OPENVIKING_ENDPOINT,
   OpenVikingClient,
+  OpenVikingSettingsSection,
   OpenVikingStatusChip,
   OpenVikingStatusPopover,
   THEME,