@hermespilot/link 0.6.8 → 0.7.0

package/dist/cli/index.js

@@ -17,6 +17,7 @@ import {
   ensureHermesApiServerAvailable,
   ensureHermesApiServerConfig,
   ensureHermesLinkSkillInstalledBestEffort,
+  ensureHermesUsageProbeForProfiles,
   ensureIdentity,
   fetchRelayStreamBatchPolicy,
   flushLogFiles,
@@ -50,8 +51,9 @@ import {
   startDaemonProcess,
   startLinkService,
   stopDaemonProcess,
+  summarizeUsageProbeEnsure,
   translate
-} from "../chunk-57ZJLOQA.js";
+} from "../chunk-XWQRIQVR.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -905,6 +907,7 @@ program.command("start").description(helpText("start.description")).action(async
       paths,
       source: "cli_start_already_running"
     });
+    await ensureUsageProbeFromCli(paths, t, language, false, "cli_start_already_running");
     return;
   }
   const nextStatus = await startDaemonProcess(paths);
@@ -913,6 +916,7 @@ program.command("start").description(helpText("start.description")).action(async
     paths,
     source: "cli_start"
   });
+  await ensureUsageProbeFromCli(paths, t, language, true, "cli_start");
 });
 program.command("stop").description(helpText("stop.description")).action(async () => {
   const config = await loadConfig();
@@ -938,6 +942,7 @@ program.command("restart").description(helpText("restart.description")).action(a
     paths,
     source: "cli_restart"
   });
+  await ensureUsageProbeFromCli(paths, t, language, true, "cli_restart");
 });
 program.command("deliver").argument("<staging-dir>").description(helpText("deliver.description")).action(async (stagingDir) => {
   const paths = resolveRuntimePaths();
@@ -1162,6 +1167,7 @@ logsCommand.command("flush").description(helpText("logs.flush.description")).opt
   );
 });
 program.command("doctor").option("--install", helpText("doctor.installOnly")).option("--no-profiles", helpText("doctor.noProfiles")).description(helpText("doctor.description")).action(async (options) => {
+  const paths = resolveRuntimePaths();
   const installInfo = readInstallPathInfo();
   const installLanguage = await loadCliLanguage().catch(() => detectSystemLanguage());
   const installT = translate.bind(null, installLanguage);
@@ -1172,7 +1178,7 @@ program.command("doctor").option("--install", helpText("doctor.installOnly")).op
   if (hasInstallPathIssue(installInfo)) {
     printInstallDiagnostics(installInfo, installT, false);
   }
-  const [identity, config] = await Promise.all([ensureIdentity(), loadConfig()]);
+  const [identity, config] = await Promise.all([ensureIdentity(paths), loadConfig(paths)]);
   const language = resolveLanguage(config.language);
   const t = translate.bind(null, language);
   const hermesConfig = await ensureHermesApiServerConfig("default", void 0, language);
@@ -1203,8 +1209,9 @@ program.command("doctor").option("--install", helpText("doctor.installOnly")).op
   } catch (error) {
     console.log(formatHermesApiServerUnavailable(error, language));
   }
+  const usageProbe = await ensureUsageProbeFromCli(paths, t, language, true, "cli_doctor");
   if (options.profiles !== false) {
-    await printProfileDiagnostics(t);
+    await printProfileDiagnostics(t, usageProbe.profiles);
   }
 });
 if (isCliEntrypoint()) {
@@ -1218,18 +1225,74 @@ async function loadCliLanguage() {
   const config = await loadConfig();
   return resolveLanguage(config.language);
 }
-async function printProfileDiagnostics(t) {
+async function ensureUsageProbeFromCli(paths, t, language, activateGateways, source) {
+  console.log(t("usageProbe.ensure.started"));
+  let failedBeforeProfileScan = false;
+  const result = await ensureHermesUsageProbeForProfiles({
+    paths,
+    language,
+    activateGateways,
+    retryLinkDisabled: source === "cli_start" || source === "cli_restart" || source === "cli_doctor",
+    source
+  }).catch((error) => {
+    failedBeforeProfileScan = true;
+    console.log(
+      t("usageProbe.ensure.failedNonBlocking", {
+        failed: 1,
+        ready: 0,
+        total: 1
+      })
+    );
+    console.log(error instanceof Error ? error.message : String(error));
+    return { profiles: [] };
+  });
+  if (failedBeforeProfileScan) {
+    return result;
+  }
+  const summary = summarizeUsageProbeEnsure(result);
+  const attentionCount = summary.failed + summary.needsRestart + summary.disabled;
+  if (attentionCount > 0) {
+    console.log(
+      t(
+        summary.ready > 0 || summary.needsRestart > 0 || summary.disabled > 0 ? "usageProbe.ensure.partial" : "usageProbe.ensure.failedNonBlocking",
+        {
+          ready: summary.ready,
+          total: summary.total,
+          failed: attentionCount
+        }
+      )
+    );
+  } else {
+    console.log(
+      t("usageProbe.ensure.done", {
+        ready: summary.ready,
+        total: summary.total
+      })
+    );
+  }
+  return result;
+}
+async function printProfileDiagnostics(t, usageProbeProfiles = []) {
   console.log(t("doctor.profilesHeader"));
   const profiles = await prepareHermesProfilesForUse();
   if (profiles.length === 0) {
     console.log(t("doctor.profilesNone"));
     return;
   }
+  const usageProbeByProfile = new Map(
+    usageProbeProfiles.map((profile) => [profile.profile, profile])
+  );
   for (const profile of profiles) {
-    console.log(await formatProfileDiagnosticLine(profile, t));
+    console.log(
+      await formatProfileDiagnosticLine(
+        profile,
+        t,
+        usageProbeByProfile.get(profile.profile.name)
+      )
+    );
   }
 }
-async function formatProfileDiagnosticLine(profile, t) {
+async function formatProfileDiagnosticLine(profile, t, usageProbe) {
   if (profile.error || !profile.apiServer) {
     return t("doctor.profileLine", {
       profile: profile.profile.name,
@@ -1251,12 +1314,48 @@ async function formatProfileDiagnosticLine(profile, t) {
     message: health.issue ?? t("status.unknown")
   });
   const state = profile.changed ? t("doctor.profilePreparedState", { state: baseState }) : baseState;
+  const usageProbeState = usageProbe ? formatUsageProbeState(usageProbe, t) : null;
   return t("doctor.profileLine", {
     profile: profile.profile.name,
     endpoint: `${host}:${port}`,
-    state
+    state: usageProbeState ? `${state}; ${usageProbeState}` : state
   });
 }
+function formatUsageProbeState(profile, t) {
+  if (profile.disabledByUser) {
+    return t("usageProbe.disabledByUser");
+  }
+  if (profile.error) {
+    if (profile.error.includes("unmanaged Hermes plugin file")) {
+      return t("usageProbe.installConflict", { message: profile.error });
+    }
+    if (profile.error.includes("plugins.enabled")) {
+      return t("usageProbe.configInvalid", { message: profile.error });
+    }
+    if (profile.restart.attempted && profile.restart.error) {
+      return t("usageProbe.gateway.restartFailed", {
+        message: profile.restart.error
+      });
+    }
+    return t("usageProbe.configInvalid", { message: profile.error });
+  }
+  if (profile.restart.succeeded) {
+    return t("usageProbe.gateway.restartDone");
+  }
+  if (profile.needsRestart) {
+    return t("usageProbe.profile.needsRestart");
+  }
+  if (profile.pluginChanged && profile.configChanged) {
+    return t("usageProbe.profile.installed");
+  }
+  if (profile.pluginChanged) {
+    return t("usageProbe.profile.updated");
+  }
+  if (profile.configChanged) {
+    return t("usageProbe.profile.enabled");
+  }
+  return t("usageProbe.profile.ready");
+}
 function buildRelayStatusPayload(input) {
   if (!input.paired) {
     return emptyRelayStatus(input.relayConfigured, "not_paired");

package/dist/http/app.d.ts

@@ -10,6 +10,8 @@ interface ConversationProfileSummary {
 interface ConversationSummary {
     id: string;
     title: string;
+    display_title?: string;
+    title_source?: ConversationTitleSource;
     created_at: string;
     updated_at: string;
     last_event_seq: number;
@@ -51,10 +53,11 @@ interface ConversationRuntimeMetadata {
         used_tokens?: number;
         window_tokens?: number;
         usage_percent?: number;
-        source: 'explicit' | 'estimated' | 'unknown';
+        source: 'explicit' | 'probe' | 'estimated' | 'unknown';
         updated_at?: string;
     };
 }
+type ConversationTitleSource = 'default' | 'temporary_user_message' | 'temporary_fallback' | 'manual' | 'generated' | 'hermes';
 interface ConversationMessagesPageInfo {
     limit: number;
     has_more_before: boolean;
@@ -248,6 +251,9 @@ interface ConversationArchivePlan {
 interface LinkRun {
     id: string;
     kind?: 'agent' | 'command';
+    queue_mode?: 'guided_interrupt';
+    queue_promoted_at?: string;
+    guided_after_run_id?: string;
     hermes_run_id?: string;
     hermes_response_id?: string;
     previous_response_id?: string;
@@ -263,6 +269,9 @@ interface LinkRun {
     profile_uid?: string;
     profile_name_snapshot?: string;
     profile?: string;
+    owner_account_id?: string;
+    owner_app_instance_id?: string;
+    language?: string;
     model?: string;
     provider?: string;
     context_window?: number;
@@ -273,7 +282,7 @@ interface LinkRun {
         context_tokens?: number;
         context_window?: number;
         usage_percent?: number;
-        context_source?: 'explicit' | 'estimated';
+        context_source?: 'explicit' | 'probe' | 'estimated';
     };
 }
 interface SendMessageInput {
@@ -283,6 +292,9 @@ interface SendMessageInput {
     clientMessageId?: string;
     idempotencyKey?: string;
     profileName?: string;
+    accountId?: string;
+    appInstanceId?: string;
+    language?: string;
 }
 interface MessageAttachmentInput {
     blob_id?: string;
@@ -308,12 +320,18 @@ interface SendMessageResult {
     run: Pick<LinkRun, 'id' | 'status'>;
     last_event_seq: number;
     conversation?: ConversationSummary;
+    runtime?: ConversationRuntimeMetadata;
 }
 interface CancelRunResult {
     conversation_id: string;
     run: Pick<LinkRun, 'id' | 'status'>;
     last_event_seq: number;
 }
+interface QueuedRunActionResult {
+    conversation_id: string;
+    queued_run: Pick<LinkRun, 'id' | 'status'>;
+    last_event_seq: number;
+}
 type ConversationEventListener = (event: ConversationEvent) => void;
 
 interface LinkStatistics {
@@ -425,6 +443,7 @@ declare class ConversationService {
     private readonly queries;
     private readonly runLifecycle;
     private hermesSessionSyncPromise;
+    private cronDeliverySyncPromise;
     constructor(paths: RuntimePaths, logger: FileLogger);
     private withConversationLock;
     private restoreArchivedConversationForUserContinuationLocked;
@@ -452,20 +471,33 @@ declare class ConversationService {
     createConversation(input?: {
         title?: string;
         profileName?: string;
+        accountId?: string;
+        appInstanceId?: string;
     }): Promise<ConversationSummary>;
     ensureCronInboxConversation(input?: {
         profileName?: string;
     }): Promise<string>;
     appendCronDelivery(input: {
-        conversationId: string;
+        conversationId?: string;
         profileName: string;
         jobId: string;
+        source: 'app' | 'natural_language';
         jobName?: string;
         outputPath: string;
         content: string;
+        failed?: boolean;
         runAt?: string;
-    }): Promise<void>;
+        accountId?: string;
+        appInstanceId?: string;
+    }): Promise<boolean>;
+    private appendCronDeliveryToBoundConversation;
+    private findImportedCronConversation;
+    private reportCronNotification;
     syncCronDeliveries(): Promise<void>;
+    backfillCronOwnership(input: {
+        accountId?: string;
+        appInstanceId?: string;
+    }): Promise<void>;
     syncHermesSessions(): Promise<HermesSessionSyncResult>;
     deliverStagedFiles(stagingDir: string): Promise<ImportMediaReferencesResult>;
     getMessages(conversationId: string, options?: ConversationMessagesPageOptions): Promise<{
@@ -477,7 +509,7 @@ declare class ConversationService {
     }>;
     setConversationModel(conversationId: string, modelId: string): Promise<{
         conversation_id: string;
-        model_override: string;
+        default_model: string;
         runtime: ConversationRuntimeMetadata;
         last_event_seq: number;
     }>;
@@ -508,6 +540,8 @@ declare class ConversationService {
     sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
     cancelRun(conversationId: string, runId: string): Promise<CancelRunResult>;
     cancelRunById(runId: string): Promise<CancelRunResult>;
+    guideQueuedRun(conversationId: string, runId: string): Promise<QueuedRunActionResult>;
+    cancelQueuedRun(conversationId: string, runId: string): Promise<QueuedRunActionResult>;
     resolveApproval(input: {
         conversationId: string;
         approvalId: string;

package/dist/http/app.js

@@ -1,6 +1,6 @@
 import {
   createApp
-} from "../chunk-57ZJLOQA.js";
+} from "../chunk-XWQRIQVR.js";
 export {
   createApp
 };

package/package.json

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