@hermespilot/link 0.3.6 → 0.3.7

package/README.md

@@ -4,7 +4,7 @@
 
 ## Requirements
 
-- Node.js 22.14.0 or newer
+- Node.js 20.0.0 or newer
 - A local hermes-agent setup on the same machine. HermesPilot Link uses the Hermes Agent API Server on `127.0.0.1:8642`.
 
 ## Install

package/dist/{chunk-773L37RF.js → chunk-TZVQZFWU.js}

@@ -9,8 +9,21 @@ import { randomUUID as randomUUID7 } from "crypto";
 // src/database/link-database.ts
 import { mkdir } from "fs/promises";
 import { randomUUID } from "crypto";
-import { createRequire } from "module";
 import path from "path";
+
+// src/database/sqlite.ts
+import Database from "better-sqlite3";
+function openSqliteDatabase(filePath, options = {}) {
+  return new Database(filePath, {
+    ...options.readonly === void 0 ? {} : {
+      readonly: options.readonly,
+      fileMustExist: options.readonly
+    },
+    ...options.timeout === void 0 ? {} : { timeout: options.timeout }
+  });
+}
+
+// src/database/link-database.ts
 var MIGRATIONS = [
   {
     version: 1,
@@ -136,7 +149,6 @@ var MIGRATIONS = [
     `
   }
 ];
-var nodeRequire = createRequire(import.meta.url);
 async function migrateLinkDatabase(paths) {
   await mkdir(path.dirname(paths.databaseFile), { recursive: true, mode: 448 });
   const db = openDatabase(paths);
@@ -210,6 +222,92 @@ async function upsertConversationStats(paths, record) {
     db.close();
   }
 }
+async function listConversationStatsPage(paths, input) {
+  await migrateLinkDatabase(paths);
+  const rawLimit = Number.isFinite(input.limit) ? Math.trunc(input.limit) : 25;
+  const limit = Math.max(1, Math.min(100, rawLimit));
+  const db = openDatabase(paths);
+  try {
+    const conditions = ["status = ?"];
+    const params = ["active"];
+    if (input.cursor) {
+      conditions.push(`(
+        updated_at < ?
+        OR (updated_at = ? AND conversation_id < ?)
+      )`);
+      params.push(
+        input.cursor.updatedAt,
+        input.cursor.updatedAt,
+        input.cursor.conversationId
+      );
+    }
+    const rows = db.prepare(`
+      SELECT conversation_id, updated_at
+      FROM conversation_stats
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY updated_at DESC, conversation_id DESC
+      LIMIT ?
+    `).all(...params, limit + 1);
+    const records = rows.slice(0, limit).map((row) => ({
+      conversationId: readString(row, "conversation_id") ?? "",
+      updatedAt: readString(row, "updated_at") ?? ""
+    })).filter((row) => row.conversationId && row.updatedAt);
+    return {
+      records,
+      hasMore: rows.length > limit
+    };
+  } finally {
+    db.close();
+  }
+}
+async function searchConversationStatsPage(paths, input) {
+  await migrateLinkDatabase(paths);
+  const rawLimit = Number.isFinite(input.limit) ? Math.trunc(input.limit) : 25;
+  const limit = Math.max(1, Math.min(100, rawLimit));
+  const query = input.query.trim();
+  if (!query) {
+    return listConversationStatsPage(paths, {
+      limit,
+      cursor: input.cursor
+    });
+  }
+  const db = openDatabase(paths);
+  try {
+    const conditions = ["status = ?", "LOWER(title) LIKE ? ESCAPE '\\'"];
+    const params = [
+      "active",
+      `%${escapeSqlLike(query.toLowerCase())}%`
+    ];
+    if (input.cursor) {
+      conditions.push(`(
+        updated_at < ?
+        OR (updated_at = ? AND conversation_id < ?)
+      )`);
+      params.push(
+        input.cursor.updatedAt,
+        input.cursor.updatedAt,
+        input.cursor.conversationId
+      );
+    }
+    const rows = db.prepare(`
+      SELECT conversation_id, updated_at
+      FROM conversation_stats
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY updated_at DESC, conversation_id DESC
+      LIMIT ?
+    `).all(...params, limit + 1);
+    const records = rows.slice(0, limit).map((row) => ({
+      conversationId: readString(row, "conversation_id") ?? "",
+      updatedAt: readString(row, "updated_at") ?? ""
+    })).filter((row) => row.conversationId && row.updatedAt);
+    return {
+      records,
+      hasMore: rows.length > limit
+    };
+  } finally {
+    db.close();
+  }
+}
 async function replaceRunUsageFactsForConversation(paths, conversationId, records) {
   await migrateLinkDatabase(paths);
   const db = openDatabase(paths);
@@ -618,8 +716,7 @@ async function deleteConversationStatsForProfile(paths, input) {
   }
 }
 function openDatabase(paths) {
-  const { DatabaseSync } = nodeRequire("node:sqlite");
-  const db = new DatabaseSync(paths.databaseFile, {
+  const db = openSqliteDatabase(paths.databaseFile, {
     timeout: 5e3
   });
   db.exec(`
@@ -826,6 +923,9 @@ function readString(row, key) {
   const value = row?.[key];
   return typeof value === "string" && value.trim() ? value : void 0;
 }
+function escapeSqlLike(value) {
+  return value.replace(/[\\%_]/gu, (match) => `\\${match}`);
+}
 function statisticsWhereClause(filter) {
   const profileUid = filter.profileUid?.trim();
   const profileName = filter.profileName?.trim();
@@ -3724,7 +3824,7 @@ import os2 from "os";
 import path5 from "path";
 
 // src/constants.ts
-var LINK_VERSION = "0.3.6";
+var LINK_VERSION = "0.3.7";
 var LINK_COMMAND = "hermeslink";
 var LINK_DEFAULT_PORT = 52379;
 var LINK_RUNTIME_DIR_NAME = ".hermeslink";
@@ -6753,9 +6853,7 @@ function isUsableLanIpv4(value) {
 
 // src/hermes/session-title.ts
 import { stat as stat6 } from "fs/promises";
-import { createRequire as createRequire2 } from "module";
 import path11 from "path";
-var nodeRequire2 = createRequire2(import.meta.url);
 async function readHermesSessionTitle(sessionId, paths, profileName) {
   const trimmedSessionId = sessionId.trim();
   if (!trimmedSessionId) {
@@ -6801,11 +6899,8 @@ async function readHermesCompressionTip(sessionId, paths, profileName) {
 function readSessionTitleFromStateDb(dbPath, sessionId) {
   let db = null;
   try {
-    const { DatabaseSync } = nodeRequire2(
-      "node:sqlite"
-    );
-    db = new DatabaseSync(dbPath, {
-      readOnly: true,
+    db = openSqliteDatabase(dbPath, {
+      readonly: true,
       timeout: 1e3
     });
     const row = db.prepare("SELECT title FROM sessions WHERE id = ? LIMIT 1").get(sessionId);
@@ -6820,11 +6915,8 @@ function readSessionTitleFromStateDb(dbPath, sessionId) {
 function readCompressionTipFromStateDb(dbPath, sessionId) {
   let db = null;
   try {
-    const { DatabaseSync } = nodeRequire2(
-      "node:sqlite"
-    );
-    db = new DatabaseSync(dbPath, {
-      readOnly: true,
+    db = openSqliteDatabase(dbPath, {
+      readonly: true,
       timeout: 1e3
     });
     let current = sessionId;
@@ -8284,12 +8376,63 @@ function toRecord6(value) {
 }
 
 // src/conversations/conversation-queries.ts
+var DEFAULT_CONVERSATION_LIST_PAGE_SIZE = 25;
+var MAX_CONVERSATION_LIST_PAGE_SIZE = 100;
 var ConversationQueryCoordinator = class {
   constructor(deps) {
     this.deps = deps;
   }
   deps;
   async listConversations() {
+    return this.listConversationsFromStore();
+  }
+  async listConversationPage(options = {}) {
+    const limit = normalizeConversationListPageLimit(options.limit);
+    const cursor = decodeConversationListCursor(options.cursor);
+    const indexedPage = await listConversationStatsPage(this.deps.paths, {
+      limit,
+      cursor
+    });
+    if (indexedPage.records.length === 0) {
+      return this.listConversationPageFromStore({ limit, cursor });
+    }
+    const summaries = await this.summarizeIndexedConversations(
+      indexedPage.records
+    );
+    return {
+      conversations: summaries,
+      page: {
+        limit,
+        has_more: indexedPage.hasMore,
+        next_cursor: indexedPage.hasMore && indexedPage.records.length > 0 ? encodeConversationListCursor(indexedPage.records.at(-1)) : null
+      }
+    };
+  }
+  async searchConversationPage(options = {}) {
+    const query = normalizeConversationSearchQuery(options.query);
+    if (!query) {
+      return this.listConversationPage(options);
+    }
+    const limit = normalizeConversationListPageLimit(options.limit);
+    const cursor = decodeConversationListCursor(options.cursor);
+    const indexedPage = await searchConversationStatsPage(this.deps.paths, {
+      limit,
+      cursor,
+      query
+    });
+    const summaries = await this.summarizeIndexedConversations(
+      indexedPage.records
+    );
+    return {
+      conversations: summaries,
+      page: {
+        limit,
+        has_more: indexedPage.hasMore,
+        next_cursor: indexedPage.hasMore && indexedPage.records.length > 0 ? encodeConversationListCursor(indexedPage.records.at(-1)) : null
+      }
+    };
+  }
+  async listConversationsFromStore() {
     const summaries = [];
     for (const conversationId of await this.deps.store.listConversationIds()) {
       const manifest = await this.deps.store.readManifest(conversationId).catch(
@@ -8305,9 +8448,41 @@ var ConversationQueryCoordinator = class {
       summaries.push(await this.summarizeConversation(refreshed, snapshot));
     }
     return summaries.sort(
-      (left, right) => Date.parse(right.updated_at) - Date.parse(left.updated_at)
+      (left, right) => Date.parse(right.updated_at) - Date.parse(left.updated_at) || right.id.localeCompare(left.id)
     );
   }
+  async listConversationPageFromStore(input) {
+    const all = await this.listConversationsFromStore();
+    const startIndex = input.cursor ? all.findIndex((summary) => isAfterConversationListCursor(summary, input.cursor)) : 0;
+    const safeStartIndex = startIndex < 0 ? all.length : startIndex;
+    const conversations = all.slice(safeStartIndex, safeStartIndex + input.limit);
+    const hasMore = safeStartIndex + input.limit < all.length;
+    return {
+      conversations,
+      page: {
+        limit: input.limit,
+        has_more: hasMore,
+        next_cursor: hasMore && conversations.length > 0 ? encodeConversationListCursorFromSummary(conversations.at(-1)) : null
+      }
+    };
+  }
+  async summarizeIndexedConversations(records) {
+    const summaries = [];
+    for (const record of records) {
+      const manifest = await this.deps.store.readManifest(record.conversationId).catch(
+        () => null
+      );
+      if (!manifest || manifest.status !== "active") {
+        continue;
+      }
+      const snapshot = await this.deps.store.readSnapshot(record.conversationId).catch(
+        () => emptySnapshot2()
+      );
+      const refreshed = await this.deps.metadata.refreshTitleFromHermes(manifest, { snapshot }).catch(() => manifest);
+      summaries.push(await this.summarizeConversation(refreshed, snapshot));
+    }
+    return summaries;
+  }
   async getMessages(conversationId, options = {}) {
     const manifest = await this.deps.store.readActiveManifest(conversationId);
     const snapshot = await this.deps.store.readSnapshot(conversationId);
@@ -8394,6 +8569,61 @@ var ConversationQueryCoordinator = class {
     });
   }
 };
+function normalizeConversationListPageLimit(value) {
+  if (value === void 0 || !Number.isFinite(value)) {
+    return DEFAULT_CONVERSATION_LIST_PAGE_SIZE;
+  }
+  return Math.max(
+    1,
+    Math.min(MAX_CONVERSATION_LIST_PAGE_SIZE, Math.floor(value))
+  );
+}
+function encodeConversationListCursor(record) {
+  return Buffer.from(
+    JSON.stringify({
+      updated_at: record.updatedAt,
+      conversation_id: record.conversationId
+    }),
+    "utf8"
+  ).toString("base64url");
+}
+function encodeConversationListCursorFromSummary(summary) {
+  return encodeConversationListCursor({
+    conversationId: summary.id,
+    updatedAt: summary.updated_at
+  });
+}
+function decodeConversationListCursor(value) {
+  if (!value) {
+    return null;
+  }
+  try {
+    const decoded = JSON.parse(
+      Buffer.from(value, "base64url").toString("utf8")
+    );
+    const updatedAt = readNonEmptyString(decoded.updated_at);
+    const conversationId = readNonEmptyString(decoded.conversation_id);
+    if (!updatedAt || !conversationId) {
+      throw new Error("invalid cursor");
+    }
+    return { updatedAt, conversationId };
+  } catch {
+    throw new LinkHttpError(
+      400,
+      "conversation_cursor_invalid",
+      "Conversation list cursor is invalid"
+    );
+  }
+}
+function readNonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function normalizeConversationSearchQuery(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function isAfterConversationListCursor(summary, cursor) {
+  return summary.updated_at < cursor.updatedAt || summary.updated_at === cursor.updatedAt && summary.id < cursor.conversationId;
+}
 function hydrateAgentEventBlocks(blocks, agentEvents) {
   if (!blocks?.length || agentEvents.length === 0) {
     return blocks;
@@ -8569,7 +8799,6 @@ function isNodeError8(error, code) {
 // src/conversations/hermes-session-sync.ts
 import { randomUUID as randomUUID6 } from "crypto";
 import { readdir as readdir6, readFile as readFile9, stat as stat8 } from "fs/promises";
-import { createRequire as createRequire3 } from "module";
 import os4 from "os";
 import path14 from "path";
 
@@ -8904,7 +9133,6 @@ function isNodeError9(error, code) {
 }
 
 // src/conversations/hermes-session-sync.ts
-var nodeRequire3 = createRequire3(import.meta.url);
 var PROFILE_NAME_PATTERN3 = /^[a-zA-Z0-9._-]{1,64}$/u;
 var DEFAULT_PROFILE_NAME = "default";
 var MAX_IMPORTABLE_SESSIONS = 100;
@@ -9696,11 +9924,8 @@ async function listProfileSessions(dbPath) {
   }
   let db = null;
   try {
-    const { DatabaseSync } = nodeRequire3(
-      "node:sqlite"
-    );
-    db = new DatabaseSync(dbPath, {
-      readOnly: true,
+    db = openSqliteDatabase(dbPath, {
+      readonly: true,
       timeout: 1e3
     });
     const sessionColumns = readTableColumns(db, "sessions");
@@ -9840,11 +10065,8 @@ async function readStateDbMessages(dbPath, sessionId) {
   }
   let db = null;
   try {
-    const { DatabaseSync } = nodeRequire3(
-      "node:sqlite"
-    );
-    db = new DatabaseSync(dbPath, {
-      readOnly: true,
+    db = openSqliteDatabase(dbPath, {
+      readonly: true,
       timeout: 1e3
     });
     const columns = readTableColumns(db, "messages");
@@ -10585,9 +10807,7 @@ function readString10(payload, key) {
 
 // src/conversations/history-builder.ts
 import { readFile as readFile10, stat as stat9 } from "fs/promises";
-import { createRequire as createRequire4 } from "module";
 import path15 from "path";
-var nodeRequire4 = createRequire4(import.meta.url);
 var HISTORY_ROLES = /* @__PURE__ */ new Set(["user", "assistant"]);
 var HERMES_HISTORY_COLUMNS = [
   "role",
@@ -10749,11 +10969,8 @@ async function readHermesJsonlHistory(sessionsDir, sessionId) {
 function readHistoryRows(dbPath, sessionId) {
   let db = null;
   try {
-    const { DatabaseSync } = nodeRequire4(
-      "node:sqlite"
-    );
-    db = new DatabaseSync(dbPath, {
-      readOnly: true,
+    db = openSqliteDatabase(dbPath, {
+      readonly: true,
       timeout: 1e3
     });
     const columns = readTableColumns2(db, "messages");
@@ -12744,6 +12961,12 @@ var ConversationService = class {
   async listConversations() {
     return this.queries.listConversations();
   }
+  listConversationPage(input = {}) {
+    return this.queries.listConversationPage(input);
+  }
+  searchConversationPage(input = {}) {
+    return this.queries.searchConversationPage(input);
+  }
   async getStatistics(filter = {}) {
     return readLinkStatistics(this.paths, filter);
   }
@@ -14291,9 +14514,28 @@ function registerConversationRoutes(router, options) {
   router.get("/api/v1/conversations", async (ctx) => {
     await authenticateRequest(ctx, paths);
     ctx.set("cache-control", "no-store");
+    const result = await conversations.listConversationPage({
+      limit: readLimit(ctx.query.limit),
+      cursor: readQueryString(ctx.query.cursor) ?? readQueryString(ctx.query.after) ?? readQueryString(ctx.query.page_cursor)
+    });
+    ctx.body = {
+      ok: true,
+      conversations: result.conversations,
+      page: result.page
+    };
+  });
+  router.get("/api/v1/conversations/search", async (ctx) => {
+    await authenticateRequest(ctx, paths);
+    ctx.set("cache-control", "no-store");
+    const result = await conversations.searchConversationPage({
+      limit: readLimit(ctx.query.limit),
+      cursor: readQueryString(ctx.query.cursor) ?? readQueryString(ctx.query.after) ?? readQueryString(ctx.query.page_cursor),
+      query: readQueryString(ctx.query.query) ?? readQueryString(ctx.query.q) ?? readQueryString(ctx.query.keyword) ?? ""
+    });
     ctx.body = {
       ok: true,
-      conversations: await conversations.listConversations()
+      conversations: result.conversations,
+      page: result.page
     };
   });
   router.post("/api/v1/conversations", async (ctx) => {
@@ -20093,6 +20335,7 @@ var DEFAULT_STARTUP_REPORT_MIN_INTERVAL_MS = 15 * 6e4;
 function startLanIpMonitor(options) {
   let running = false;
   let closed = false;
+  let current = Promise.resolve();
   const check = async (context = {}) => {
     if (running || closed) {
       return;
@@ -20108,15 +20351,16 @@ function startLanIpMonitor(options) {
       running = false;
     }
   };
-  void check({ forceReport: true, publishToRelay: true });
+  current = check({ forceReport: true, publishToRelay: true });
   const timer = setInterval(() => {
-    void check();
+    current = check();
   }, options.intervalMs ?? DEFAULT_INTERVAL_MS);
   timer.unref?.();
   return {
-    close() {
+    async close() {
       closed = true;
       clearInterval(timer);
+      await current.catch(() => void 0);
     }
   };
 }
@@ -20186,6 +20430,7 @@ async function checkLanIpChange(options, context = {}) {
 // src/daemon/scheduler.ts
 function startCronDeliveryScheduler(options) {
   let running = false;
+  let current = Promise.resolve();
   const syncCronDeliveries = async () => {
     if (running) {
       return;
@@ -20206,17 +20451,19 @@ function startCronDeliveryScheduler(options) {
     }
   };
   const timer = setInterval(() => {
-    void syncCronDeliveries();
+    current = syncCronDeliveries();
   }, options.intervalMs ?? 3e4);
   timer.unref?.();
   return {
-    close() {
+    async close() {
       clearInterval(timer);
+      await current.catch(() => void 0);
     }
   };
 }
 function startHermesSessionSyncScheduler(options) {
   let running = false;
+  let current = Promise.resolve();
   const syncSessions = async () => {
     if (running) {
       return;
@@ -20233,12 +20480,13 @@ function startHermesSessionSyncScheduler(options) {
     }
   };
   const timer = setInterval(() => {
-    void syncSessions();
+    current = syncSessions();
   }, options.intervalMs ?? 10 * 60 * 1e3);
   timer.unref?.();
   return {
-    close() {
+    async close() {
       clearInterval(timer);
+      await current.catch(() => void 0);
     }
   };
 }
@@ -20262,8 +20510,9 @@ async function startLinkService(options = {}) {
   }
   const conversations = new ConversationService(paths, logger);
   await conversations.rebuildStatisticsIndex();
+  let hermesSessionSync = Promise.resolve();
   const triggerHermesSessionSync = () => {
-    void conversations.syncHermesSessions().catch((error) => {
+    hermesSessionSync = Promise.resolve().then(() => conversations.syncHermesSessions()).then(() => void 0).catch((error) => {
       void logger.warn("hermes_session_sync_failed", {
         error: error instanceof Error ? error.message : String(error)
       });
@@ -20337,11 +20586,14 @@ async function startLinkService(options = {}) {
   }
   return {
     async close() {
-      scheduler.close();
-      hermesSessionSyncScheduler.close();
-      lanIpMonitor.close();
       relay?.close();
       await closeServer(server);
+      await Promise.all([
+        scheduler.close(),
+        hermesSessionSyncScheduler.close(),
+        lanIpMonitor.close(),
+        hermesSessionSync.catch(() => void 0)
+      ]);
       await logger.info("service_stopped");
       await logger.flush();
       if (options.writePidFile) {

package/dist/cli/index.js

@@ -32,7 +32,7 @@ import {
   startDaemonProcess,
   startLinkService,
   stopDaemonProcess
-} from "../chunk-773L37RF.js";
+} from "../chunk-TZVQZFWU.js";
 
 // src/cli/index.ts
 import { Command } from "commander";

package/dist/http/app.d.ts

@@ -1,82 +1,5 @@
 import Koa from 'koa';
 
-interface RuntimePaths {
-    homeDir: string;
-    identityFile: string;
-    configFile: string;
-    stateFile: string;
-    credentialsFile: string;
-    databaseFile: string;
-    conversationsDir: string;
-    blobsDir: string;
-    indexesDir: string;
-    logsDir: string;
-    runDir: string;
-    pairingDir: string;
-}
-
-interface LinkStatistics {
-    conversations: {
-        total: number;
-        active: number;
-        deleted: number;
-    };
-    tokens: {
-        input_tokens: number;
-        output_tokens: number;
-        total_tokens: number;
-    };
-    messages: {
-        total: number;
-    };
-    runs: {
-        total: number;
-    };
-    models: {
-        total: number;
-    };
-    profiles: {
-        total: number;
-    };
-    skills: {
-        total: number;
-    };
-    tools: {
-        total: number;
-    };
-    updated_at?: string;
-}
-interface LinkStatisticsFilter {
-    profileUid?: string | null;
-    profileName?: string | null;
-}
-
-type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-interface FileLoggerOptions {
-    paths?: RuntimePaths;
-    fileName?: string;
-    maxFileBytes?: number;
-    maxFiles?: number;
-    now?: () => Date;
-}
-declare class FileLogger {
-    readonly filePath: string;
-    private readonly paths;
-    private readonly maxFileBytes;
-    private readonly maxFiles;
-    private readonly now;
-    private queue;
-    constructor(options?: FileLoggerOptions);
-    debug(message: string, fields?: Record<string, unknown>): Promise<void>;
-    info(message: string, fields?: Record<string, unknown>): Promise<void>;
-    warn(message: string, fields?: Record<string, unknown>): Promise<void>;
-    error(message: string, fields?: Record<string, unknown>): Promise<void>;
-    write(level: LogLevel, message: string, fields?: Record<string, unknown>): Promise<void>;
-    flush(): Promise<void>;
-    private appendEntry;
-    private rotateIfNeeded;
-}
-
 interface ConversationProfileSummary {
     uid?: string;
     name: string;
@@ -102,6 +25,15 @@ interface ConversationSummary {
         content_preview: string;
     } | null;
 }
+interface ConversationListPageInfo {
+    limit: number;
+    has_more: boolean;
+    next_cursor: string | null;
+}
+interface ConversationListPage {
+    conversations: ConversationSummary[];
+    page: ConversationListPageInfo;
+}
 interface ConversationRuntimeMetadata {
     profile: ConversationProfileSummary;
     model: {
@@ -322,6 +254,83 @@ interface CancelRunResult {
 }
 type ConversationEventListener = (event: ConversationEvent) => void;
 
+interface RuntimePaths {
+    homeDir: string;
+    identityFile: string;
+    configFile: string;
+    stateFile: string;
+    credentialsFile: string;
+    databaseFile: string;
+    conversationsDir: string;
+    blobsDir: string;
+    indexesDir: string;
+    logsDir: string;
+    runDir: string;
+    pairingDir: string;
+}
+
+interface LinkStatistics {
+    conversations: {
+        total: number;
+        active: number;
+        deleted: number;
+    };
+    tokens: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    messages: {
+        total: number;
+    };
+    runs: {
+        total: number;
+    };
+    models: {
+        total: number;
+    };
+    profiles: {
+        total: number;
+    };
+    skills: {
+        total: number;
+    };
+    tools: {
+        total: number;
+    };
+    updated_at?: string;
+}
+interface LinkStatisticsFilter {
+    profileUid?: string | null;
+    profileName?: string | null;
+}
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface FileLoggerOptions {
+    paths?: RuntimePaths;
+    fileName?: string;
+    maxFileBytes?: number;
+    maxFiles?: number;
+    now?: () => Date;
+}
+declare class FileLogger {
+    readonly filePath: string;
+    private readonly paths;
+    private readonly maxFileBytes;
+    private readonly maxFiles;
+    private readonly now;
+    private queue;
+    constructor(options?: FileLoggerOptions);
+    debug(message: string, fields?: Record<string, unknown>): Promise<void>;
+    info(message: string, fields?: Record<string, unknown>): Promise<void>;
+    warn(message: string, fields?: Record<string, unknown>): Promise<void>;
+    error(message: string, fields?: Record<string, unknown>): Promise<void>;
+    write(level: LogLevel, message: string, fields?: Record<string, unknown>): Promise<void>;
+    flush(): Promise<void>;
+    private appendEntry;
+    private rotateIfNeeded;
+}
+
 interface HermesSessionSyncResult {
     scanned_profiles: number;
     scanned_sessions: number;
@@ -367,6 +376,15 @@ declare class ConversationService {
     constructor(paths: RuntimePaths, logger: FileLogger);
     private withConversationLock;
     listConversations(): Promise<ConversationSummary[]>;
+    listConversationPage(input?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<ConversationListPage>;
+    searchConversationPage(input?: {
+        limit?: number;
+        cursor?: string;
+        query?: string;
+    }): Promise<ConversationListPage>;
     getStatistics(filter?: LinkStatisticsFilter): Promise<LinkStatistics>;
     rebuildStatisticsIndex(): Promise<void>;
     createConversation(input?: {

package/dist/http/app.js

@@ -1,6 +1,6 @@
 import {
   createApp
-} from "../chunk-773L37RF.js";
+} from "../chunk-TZVQZFWU.js";
 export {
   createApp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hermespilot/link",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "private": false,
   "description": "Hermes Link companion service and CLI for connecting hermes-agent through HermesPilot",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/cli/index.ts src/http/app.ts --format esm --target node22 --dts --clean",
+    "build": "tsup src/cli/index.ts src/http/app.ts --format esm --target node20 --dts --clean",
     "check": "tsc --noEmit",
     "dev": "tsx src/cli/index.ts",
     "preinstall": "node ./scripts/check-node-version.mjs",
@@ -41,6 +41,7 @@
   },
   "dependencies": {
     "@koa/router": "^15.4.0",
+    "better-sqlite3": "^12.9.0",
     "commander": "^12.1.0",
     "koa": "^2.15.3",
     "qrcode": "^1.5.4",
@@ -50,8 +51,9 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/koa": "^2.15.0",
-    "@types/node": "^22.10.2",
+    "@types/node": "^20.19.39",
     "@types/qrcode": "^1.5.6",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/ws": "^8.5.13",
@@ -61,6 +63,6 @@
     "vitest": "^2.1.8"
   },
   "engines": {
-    "node": ">=22.14.0"
+    "node": ">=20.0.0"
   }
 }

package/scripts/check-node-version.mjs

@@ -1,6 +1,6 @@
 import process from "node:process";
 
-const MINIMUM_NODE_VERSION = "22.14.0";
+const MINIMUM_NODE_VERSION = "20.0.0";
 
 function parseVersion(input) {
   const normalized = String(input ?? "")
@@ -55,21 +55,21 @@ if (compareVersions(current, minimum) < 0) {
   const language = detectLanguage();
   console.error("");
   if (language === "zh-CN") {
-    console.error("Hermes Link 需要 Node.js 22.14.0 或更新版本。");
+    console.error("Hermes Link 需要 Node.js 20.0.0 或更新版本。");
     console.error(`当前使用的是 Node.js ${process.versions.node}。`);
     console.error("");
     console.error("为什么需要这样做：");
-    console.error("- Hermes Link 使用和 Link daemon / CLI 一致的现代 Node.js runtime。");
-    console.error("- 如果继续在旧版 Node.js 上安装，后续配对或后台服务可能会失败。");
+    console.error("- Hermes Link 与 hermes-agent 的 Node.js 20+ 要求保持一致。");
+    console.error("- 如果继续在旧版 Node.js 上安装，后续配对、后台服务或本地数据库可能会失败。");
     console.error("");
     console.error("请先升级 Node.js，然后重新运行安装命令。");
   } else {
-    console.error("Hermes Link needs Node.js 22.14.0 or newer.");
+    console.error("Hermes Link needs Node.js 20.0.0 or newer.");
     console.error(`You are using Node.js ${process.versions.node}.`);
     console.error("");
     console.error("Why this is required:");
-    console.error("- Hermes Link targets the same modern Node.js runtime used by the Link daemon and CLI.");
-    console.error("- If installation continued on an older Node.js version, pairing or the background service could fail later.");
+    console.error("- Hermes Link now matches hermes-agent's Node.js 20+ requirement.");
+    console.error("- If installation continued on an older Node.js version, pairing, the background service, or the local database could fail later.");
     console.error("");
     console.error("Please update Node.js first, then run the install command again.");
   }