@hermespilot/link 0.3.9 → 0.4.1

package/dist/cli/index.d.ts

@@ -1 +1,6 @@
 #!/usr/bin/env node
+import { R as RuntimePaths } from '../paths-CmAiZsna.js';
+
+declare function waitForPairingOrShutdown(sessionId: string, expiresAt: string, paths: RuntimePaths): Promise<'claimed' | 'expired' | 'shutdown'>;
+
+export { waitForPairingOrShutdown };

package/dist/cli/index.js

@@ -5,6 +5,7 @@ import {
   LINK_VERSION,
   LinkHttpError,
   clearPairingClaim,
+  connectRelayControl,
   createFileLogger,
   currentCliScriptPath,
   daemonLogFile,
@@ -33,10 +34,11 @@ import {
   startDaemonProcess,
   startLinkService,
   stopDaemonProcess
-} from "../chunk-7OVDWXR7.js";
+} from "../chunk-476X63MC.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
+import path3 from "path";
 import { createInterface } from "readline/promises";
 import qrcode from "qrcode-terminal";
 
@@ -285,6 +287,7 @@ var messages = {
     "pair.openPairingPage": "If the QR code is hard to scan, you can open this page locally: {url}",
     "pair.manualCode": "You can also use the HermesPilot App manual connection mode and enter this pairing code:",
     "pair.expires": "Pairing expires in 10 minutes. Press Ctrl+C to cancel waiting.",
+    "pair.expired": "Pairing expired. Please run `hermeslink pair` again.",
     "pair.claimed": "Pairing succeeded. Starting Hermes Link in the background...",
     "pair.claimedRunning": "Pairing succeeded. Hermes Link is already running in the background.",
     "pair.relayOnlyNotice": "Network note: this {kind} environment does not expose a phone-reachable LAN/public direct address by default. The App will connect through Relay.",
@@ -379,6 +382,7 @@ var messages = {
     "pair.openPairingPage": "\u5982\u679C\u4E8C\u7EF4\u7801\u4E0D\u5BB9\u6613\u626B\u63CF\uFF0C\u4F60\u53EF\u4EE5\u5728\u672C\u673A\u6253\u5F00\u8FD9\u4E2A\u9875\u9762\uFF1A{url}",
     "pair.manualCode": "\u4F60\u4E5F\u53EF\u4EE5\u5728 HermesPilot App \u4E2D\u4F7F\u7528\u624B\u52A8\u8FDE\u63A5\u6A21\u5F0F\uFF0C\u8F93\u5165\u4EE5\u4E0B\u914D\u5BF9\u7801\u8FDB\u884C\u8FDE\u63A5\uFF1A",
     "pair.expires": "\u914D\u5BF9\u4F1A\u8BDD 10 \u5206\u949F\u540E\u8FC7\u671F\u3002\u6309 Ctrl+C \u9000\u51FA\u7B49\u5F85\u3002",
+    "pair.expired": "\u914D\u5BF9\u4F1A\u8BDD\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u91CD\u65B0\u8FD0\u884C `hermeslink pair`\u3002",
     "pair.claimed": "\u914D\u5BF9\u5DF2\u6210\u529F\u3002\u6B63\u5728\u628A Hermes Link \u5207\u6362\u5230\u540E\u53F0\u8FD0\u884C...",
     "pair.claimedRunning": "\u914D\u5BF9\u5DF2\u6210\u529F\u3002Hermes Link \u5DF2\u5728\u540E\u53F0\u6301\u7EED\u8FD0\u884C\u3002",
     "pair.relayOnlyNotice": "\u7F51\u7EDC\u63D0\u793A\uFF1A\u5F53\u524D\u662F {kind} \u73AF\u5883\uFF0C\u9ED8\u8BA4\u4E0D\u4F1A\u66B4\u9732\u624B\u673A\u53EF\u8BBF\u95EE\u7684\u5C40\u57DF\u7F51\u6216\u516C\u7F51\u76F4\u8FDE\u5730\u5740\u3002App \u4F1A\u901A\u8FC7 Relay \u8FDE\u63A5\u3002",
@@ -847,55 +851,77 @@ program.command("pair").description(helpText("pair.description")).action(async (
   }
   const reusedRunningService = probe.reusable;
   const restartReusedServiceAfterClaim = reusedRunningService && !probeBeforePair.linkId;
-  const service = reusedRunningService ? null : await startLinkService({ paths });
+  const service = reusedRunningService ? null : await startLinkService({
+    paths,
+    waitForRelayReady: true
+  });
+  let pairingRelayBridge = null;
+  if (restartReusedServiceAfterClaim) {
+    pairingRelayBridge = connectRelayControl({
+      relayBaseUrl: prepared.relayBaseUrl,
+      linkId: prepared.linkId,
+      localPort: config.port
+    });
+    pairingRelayBridge.publishNetworkRoutes(prepared.routes);
+  }
   const qrValue = JSON.stringify(prepared.qrPayload);
   const pairingPageUrl = `http://127.0.0.1:${config.port}/pair?session_id=${encodeURIComponent(prepared.sessionId)}`;
-  console.log(t("pair.scan"));
-  qrcode.generate(qrValue, { small: true });
-  await openSystemBrowser(pairingPageUrl);
-  console.log(t("pair.openPairingPage", { url: pairingPageUrl }));
-  console.log(t("pair.manualCode"));
-  console.log(prepared.code);
-  console.log(t("pair.expires"));
-  const result = await waitForPairingOrShutdown(prepared.sessionId, paths);
-  if (service) {
-    await service.close();
-  }
-  if (result === "claimed") {
-    await clearPairingClaim(prepared.sessionId, paths);
-    console.log(t(reusedRunningService ? "pair.claimedRunning" : "pair.claimed"));
-    printPostPairingNetworkNotice(prepared.routes.environment, config, t);
-    try {
-      if (hadActiveDevices) {
-        console.log(t("pair.autostartUnchanged"));
-      } else {
-        const currentAutostart = await getAutostartStatus();
-        if (currentAutostart.supported && currentAutostart.enabled) {
-          console.log(
-            t("autostart.alreadyEnabled", {
-              method: currentAutostart.method,
-              path: currentAutostart.filePath ?? ""
-            })
-          );
+  try {
+    console.log(t("pair.scan"));
+    qrcode.generate(qrValue, { small: true });
+    await openSystemBrowser(pairingPageUrl);
+    console.log(t("pair.openPairingPage", { url: pairingPageUrl }));
+    console.log(t("pair.manualCode"));
+    console.log(prepared.code);
+    console.log(t("pair.expires"));
+    const result = await waitForPairingOrShutdown(
+      prepared.sessionId,
+      prepared.expiresAt,
+      paths
+    );
+    if (service) {
+      await service.close();
+    }
+    if (result === "claimed") {
+      await clearPairingClaim(prepared.sessionId, paths);
+      console.log(t(reusedRunningService ? "pair.claimedRunning" : "pair.claimed"));
+      printPostPairingNetworkNotice(prepared.routes.environment, config, t);
+      try {
+        if (hadActiveDevices) {
+          console.log(t("pair.autostartUnchanged"));
         } else {
-          const autostart2 = await enableAutostart();
-          if (autostart2.supported && autostart2.enabled) {
-            console.log(t("autostart.enabled", { method: autostart2.method, path: autostart2.filePath ?? "" }));
+          const currentAutostart = await getAutostartStatus();
+          if (currentAutostart.supported && currentAutostart.enabled) {
+            console.log(
+              t("autostart.alreadyEnabled", {
+                method: currentAutostart.method,
+                path: currentAutostart.filePath ?? ""
+              })
+            );
+          } else {
+            const autostart2 = await enableAutostart();
+            if (autostart2.supported && autostart2.enabled) {
+              console.log(t("autostart.enabled", { method: autostart2.method, path: autostart2.filePath ?? "" }));
+            }
           }
         }
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(t("pair.autostartFailed", { message }));
       }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.log(t("pair.autostartFailed", { message }));
-    }
-    if (restartReusedServiceAfterClaim) {
-      await stopDaemonProcess(paths);
-      const status = await startDaemonProcess(paths);
-      console.log(t("start.backgroundStarted", { pid: status.pid ?? "unknown" }));
-    } else if (!reusedRunningService) {
-      const status = await startDaemonProcess(paths);
-      console.log(t("start.backgroundStarted", { pid: status.pid ?? "unknown" }));
+      if (restartReusedServiceAfterClaim) {
+        await stopDaemonProcess(paths);
+        const status = await startDaemonProcess(paths);
+        console.log(t("start.backgroundStarted", { pid: status.pid ?? "unknown" }));
+      } else if (!reusedRunningService) {
+        const status = await startDaemonProcess(paths);
+        console.log(t("start.backgroundStarted", { pid: status.pid ?? "unknown" }));
+      }
+    } else if (result === "expired") {
+      console.log(t("pair.expired"));
     }
+  } finally {
+    pairingRelayBridge?.close();
   }
 });
 var autostart = program.command("autostart").description(helpText("autostart.description"));
@@ -973,11 +999,13 @@ program.command("doctor").description(helpText("doctor.description")).action(asy
     console.log(t("doctor.apiUnavailable", { message: error instanceof Error ? error.message : String(error) }));
   }
 });
-program.parseAsync(process.argv).catch(async (error) => {
-  const language = await loadCliLanguage().catch(() => detectSystemLanguage());
-  console.error(localizeErrorMessage(error, language));
-  process.exitCode = 1;
-});
+if (isCliEntrypoint()) {
+  program.parseAsync(process.argv).catch(async (error) => {
+    const language = await loadCliLanguage().catch(() => detectSystemLanguage());
+    console.error(localizeErrorMessage(error, language));
+    process.exitCode = 1;
+  });
+}
 async function loadCliLanguage() {
   const config = await loadConfig();
   return resolveLanguage(config.language);
@@ -1083,8 +1111,9 @@ async function waitForShutdown(cleanup) {
   });
   await cleanup();
 }
-async function waitForPairingOrShutdown(sessionId, paths) {
+async function waitForPairingOrShutdown(sessionId, expiresAt, paths) {
   let shutdownRequested = false;
+  const expiresAtMs = Date.parse(expiresAt);
   const stop = () => {
     shutdownRequested = true;
   };
@@ -1092,6 +1121,9 @@ async function waitForPairingOrShutdown(sessionId, paths) {
   process.once("SIGTERM", stop);
   try {
     while (!shutdownRequested) {
+      if (Number.isFinite(expiresAtMs) && Date.now() >= expiresAtMs) {
+        return "expired";
+      }
       const record = await readPairingClaim(sessionId, paths);
       if (record) {
         return "claimed";
@@ -1124,3 +1156,10 @@ function printPostPairingNetworkNotice(environment, config, t) {
   console.log(t("pair.relayOnlyLanHostHint"));
   console.log(t("pair.relayOnlySafetyHint"));
 }
+function isCliEntrypoint() {
+  const entry = process.argv[1];
+  return Boolean(entry && import.meta.url === new URL(`file://${path3.resolve(entry)}`).href);
+}
+export {
+  waitForPairingOrShutdown
+};

package/dist/http/app.d.ts

@@ -1,4 +1,5 @@
 import Koa from 'koa';
+import { R as RuntimePaths } from '../paths-CmAiZsna.js';
 
 interface ConversationProfileSummary {
     uid?: string;
@@ -183,6 +184,19 @@ interface BulkDeleteConversationResult {
         message: string;
     };
 }
+type ConversationClearPlanStatus = 'prepared' | 'executing' | 'completed' | 'failed';
+interface ConversationClearPlan {
+    id: string;
+    status: ConversationClearPlanStatus;
+    created_at: string;
+    updated_at: string;
+    total_count: number;
+    deleted_count: number;
+    failed_count: number;
+    conversation_ids: string[];
+    conversations: BulkDeleteConversationResult[];
+    completed_at?: string;
+}
 interface LinkRun {
     id: string;
     kind?: 'agent' | 'command';
@@ -254,21 +268,6 @@ 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;
@@ -462,6 +461,10 @@ declare class ConversationService {
         last_event_seq: number;
     }>;
     deleteConversation(conversationId: string): Promise<DeleteConversationResult>;
+    prepareClearAllConversationPlan(): Promise<ConversationClearPlan>;
+    readClearAllConversationPlan(planId: string): Promise<ConversationClearPlan>;
+    executeClearAllConversationPlan(planId: string): Promise<ConversationClearPlan>;
+    startClearAllConversationPlan(planId: string): Promise<ConversationClearPlan>;
     deleteConversations(conversationIds: string[]): Promise<{
         deleted_count: number;
         failed_count: number;

package/dist/http/app.js

@@ -1,6 +1,6 @@
 import {
   createApp
-} from "../chunk-7OVDWXR7.js";
+} from "../chunk-476X63MC.js";
 export {
   createApp
 };

package/dist/paths-CmAiZsna.d.ts

@@ -0,0 +1,16 @@
+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;
+}
+
+export type { RuntimePaths as R };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hermespilot/link",
-  "version": "0.3.9",
+  "version": "0.4.1",
   "private": false,
   "description": "Hermes Link companion service and CLI for connecting hermes-agent through HermesPilot",
   "license": "MIT",