dsh-deeptutor 0.1.3 → 0.1.4

package/src/html-render.ts

@@ -1,53 +1,53 @@
-/**
- * DeepTutor bridge: render a learning answer to a self-contained local HTML file
- * via the bundled zero-dependency Node converter (scripts/md-to-html.js, from
- * the html-doc skill). Kept as a standalone module (node built-ins only).
- */
-import { execFile } from "node:child_process";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { basename, dirname, extname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-/** Absolute path to the bundled md-to-html converter script. */
-export const HTML_DOC_SCRIPT = join(
-  fileURLToPath(new URL("..", import.meta.url)),
-  "scripts",
-  "md-to-html.js",
-);
-
-/**
- * Render a learning answer to a self-contained local HTML file (dark/light toggle,
- * TOC, collapsible quiz answers, print-friendly). Also writes the companion .md
- * source next to the html file.
- *
- * Returns a short status note to append to the tool result ("" when no html path
- * given; "[html] ✗ …" note when rendering fails — never throws).
- */
-export async function renderHtml(
-  params: { html?: string; html_title?: string },
-  answer: string,
-): Promise<string> {
-  const out = params.html;
-  if (!out) return "";
-  const htmlPath = extname(out).toLowerCase() === ".html" ? resolve(out) : resolve(out + ".html");
-  const mdPath = htmlPath.slice(0, -extname(htmlPath).length) + ".md";
-  const title = params.html_title || basename(htmlPath, extname(htmlPath));
-  try {
-    if (!existsSync(HTML_DOC_SCRIPT)) {
-      return `\n[html] ✗ html-doc converter not found: ${HTML_DOC_SCRIPT}`;
-    }
-    mkdirSync(dirname(htmlPath), { recursive: true });
-    writeFileSync(mdPath, answer || "(no answer)", "utf8");
-    await new Promise<void>((res, rej) => {
-      execFile(
-        process.execPath,
-        [HTML_DOC_SCRIPT, mdPath, "--out", htmlPath, "--title", title, "--toc"],
-        { windowsHide: true, timeout: 60_000 },
-        (err, _stdout, stderr) => (err ? rej(new Error(stderr || err.message)) : res()),
-      );
-    });
-    return `\n[html] ✓ rendered (html-doc skill)\n[html]   page: ${htmlPath}\n[html]   source: ${mdPath}`;
-  } catch (err: any) {
-    return `\n[html] ✗ rendering failed: ${err?.message ?? String(err)}`;
-  }
-}
+/**
+ * DeepTutor bridge: render a learning answer to a self-contained local HTML file
+ * via the bundled zero-dependency Node converter (scripts/md-to-html.js, from
+ * the html-doc skill). Kept as a standalone module (node built-ins only).
+ */
+import { execFile } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/** Absolute path to the bundled md-to-html converter script. */
+export const HTML_DOC_SCRIPT = join(
+  fileURLToPath(new URL("..", import.meta.url)),
+  "scripts",
+  "md-to-html.js",
+);
+
+/**
+ * Render a learning answer to a self-contained local HTML file (dark/light toggle,
+ * TOC, collapsible quiz answers, print-friendly). Also writes the companion .md
+ * source next to the html file.
+ *
+ * Returns a short status note to append to the tool result ("" when no html path
+ * given; "[html] ✗ …" note when rendering fails — never throws).
+ */
+export async function renderHtml(
+  params: { html?: string; html_title?: string },
+  answer: string,
+): Promise<string> {
+  const out = params.html;
+  if (!out) return "";
+  const htmlPath = extname(out).toLowerCase() === ".html" ? resolve(out) : resolve(out + ".html");
+  const mdPath = htmlPath.slice(0, -extname(htmlPath).length) + ".md";
+  const title = params.html_title || basename(htmlPath, extname(htmlPath));
+  try {
+    if (!existsSync(HTML_DOC_SCRIPT)) {
+      return `\n[html] ✗ html-doc converter not found: ${HTML_DOC_SCRIPT}`;
+    }
+    mkdirSync(dirname(htmlPath), { recursive: true });
+    writeFileSync(mdPath, answer || "(no answer)", "utf8");
+    await new Promise<void>((res, rej) => {
+      execFile(
+        process.execPath,
+        [HTML_DOC_SCRIPT, mdPath, "--out", htmlPath, "--title", title, "--toc"],
+        { windowsHide: true, timeout: 60_000 },
+        (err, _stdout, stderr) => (err ? rej(new Error(stderr || err.message)) : res()),
+      );
+    });
+    return `\n[html] ✓ rendered (html-doc skill)\n[html]   page: ${htmlPath}\n[html]   source: ${mdPath}`;
+  } catch (err: any) {
+    return `\n[html] ✗ rendering failed: ${err?.message ?? String(err)}`;
+  }
+}

package/src/http-api.ts

@@ -1,83 +1,83 @@
-/**
- * DeepTutor bridge: HTTP/WS transport (API probing, SSH tunnel management, JSON calls).
- */
-import { spawn } from "node:child_process";
-import { API_BASE, SSH_HOST, TUNNEL_PORT } from "./config.ts";
-
-let tunnelProc: ReturnType<typeof spawn> | null = null;
-
-/** Kill the SSH tunnel process, if one is running (call on plugin disposal). */
-export function killTunnel(): void {
-  if (tunnelProc && tunnelProc.exitCode === null) {
-    try {
-      tunnelProc.kill();
-    } catch {}
-    tunnelProc = null;
-  }
-}
-
-export async function apiProbe(timeoutMs = 1500): Promise<boolean> {
-  try {
-    const res = await fetch(`${API_BASE}/api/v1/system/status`, {
-      signal: AbortSignal.timeout(timeoutMs),
-    });
-    return res.ok;
-  } catch {
-    return false;
-  }
-}
-
-/** Ensure the local API is reachable: probe → start SSH tunnel if needed (remote only) → wait. */
-export async function ensureApi(): Promise<boolean> {
-  if (await apiProbe(1200)) return true;
-  if (!SSH_HOST) return false; // Local deployment: fall back to local CLI when serve is down, no tunnel needed
-  if (!tunnelProc || tunnelProc.exitCode !== null) {
-    tunnelProc = spawn(
-      "ssh",
-      [
-        "-N",
-        "-L",
-        `${TUNNEL_PORT}:127.0.0.1:${TUNNEL_PORT}`,
-        "-o",
-        "BatchMode=yes",
-        "-o",
-        "ExitOnForwardFailure=yes",
-        "-o",
-        "ServerAliveInterval=30",
-        "-o",
-        "ServerAliveCountMax=3",
-        "-o",
-        "ConnectTimeout=10",
-        SSH_HOST,
-      ],
-      { stdio: "ignore", windowsHide: true },
-    );
-    tunnelProc.unref();
-  }
-  for (let i = 0; i < 20; i++) {
-    if (await apiProbe(1000)) return true;
-    await new Promise((r) => setTimeout(r, 500));
-  }
-  return false;
-}
-
-/** JSON fetch against the DeepTutor API. Combines a fixed timeout with an optional caller-supplied abort signal. */
-export async function apiJson(
-  path: string,
-  init?: RequestInit,
-  opts: { timeoutMs?: number; signal?: AbortSignal } = {},
-): Promise<any> {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 60_000);
-  const onAbort = () => controller.abort();
-  opts.signal?.addEventListener("abort", onAbort, { once: true });
-  try {
-    const res = await fetch(`${API_BASE}${path}`, { ...init, signal: controller.signal });
-    if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText}`);
-    const text = await res.text();
-    return text ? JSON.parse(text) : null;
-  } finally {
-    clearTimeout(timer);
-    opts.signal?.removeEventListener("abort", onAbort);
-  }
-}
+/**
+ * DeepTutor bridge: HTTP/WS transport (API probing, SSH tunnel management, JSON calls).
+ */
+import { spawn } from "node:child_process";
+import { API_BASE, SSH_HOST, TUNNEL_PORT } from "./config.ts";
+
+let tunnelProc: ReturnType<typeof spawn> | null = null;
+
+/** Kill the SSH tunnel process, if one is running (call on plugin disposal). */
+export function killTunnel(): void {
+  if (tunnelProc && tunnelProc.exitCode === null) {
+    try {
+      tunnelProc.kill();
+    } catch {}
+    tunnelProc = null;
+  }
+}
+
+export async function apiProbe(timeoutMs = 1500): Promise<boolean> {
+  try {
+    const res = await fetch(`${API_BASE}/api/v1/system/status`, {
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+/** Ensure the local API is reachable: probe → start SSH tunnel if needed (remote only) → wait. */
+export async function ensureApi(): Promise<boolean> {
+  if (await apiProbe(1200)) return true;
+  if (!SSH_HOST) return false; // Local deployment: fall back to local CLI when serve is down, no tunnel needed
+  if (!tunnelProc || tunnelProc.exitCode !== null) {
+    tunnelProc = spawn(
+      "ssh",
+      [
+        "-N",
+        "-L",
+        `${TUNNEL_PORT}:127.0.0.1:${TUNNEL_PORT}`,
+        "-o",
+        "BatchMode=yes",
+        "-o",
+        "ExitOnForwardFailure=yes",
+        "-o",
+        "ServerAliveInterval=30",
+        "-o",
+        "ServerAliveCountMax=3",
+        "-o",
+        "ConnectTimeout=10",
+        SSH_HOST,
+      ],
+      { stdio: "ignore", windowsHide: true },
+    );
+    tunnelProc.unref();
+  }
+  for (let i = 0; i < 20; i++) {
+    if (await apiProbe(1000)) return true;
+    await new Promise((r) => setTimeout(r, 500));
+  }
+  return false;
+}
+
+/** JSON fetch against the DeepTutor API. Combines a fixed timeout with an optional caller-supplied abort signal. */
+export async function apiJson(
+  path: string,
+  init?: RequestInit,
+  opts: { timeoutMs?: number; signal?: AbortSignal } = {},
+): Promise<any> {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 60_000);
+  const onAbort = () => controller.abort();
+  opts.signal?.addEventListener("abort", onAbort, { once: true });
+  try {
+    const res = await fetch(`${API_BASE}${path}`, { ...init, signal: controller.signal });
+    if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText}`);
+    const text = await res.text();
+    return text ? JSON.parse(text) : null;
+  } finally {
+    clearTimeout(timer);
+    opts.signal?.removeEventListener("abort", onAbort);
+  }
+}