@docyrus/docyrus 0.0.34 → 0.0.36

package/resources/pi-agent/extensions/pi-mcp-adapter/metadata-cache.ts

@@ -44,12 +44,12 @@ export function getMetadataCachePath(): string {
 }
 
 export function loadMetadataCache(): MetadataCache | null {
-  if (!existsSync(CACHE_PATH)) return null;
+  if (!existsSync(CACHE_PATH)) {return null;}
   try {
     const raw = JSON.parse(readFileSync(CACHE_PATH, "utf-8"));
-    if (!raw || typeof raw !== "object") return null;
-    if (raw.version !== CACHE_VERSION) return null;
-    if (!raw.servers || typeof raw.servers !== "object") return null;
+    if (!raw || typeof raw !== "object") {return null;}
+    if (raw.version !== CACHE_VERSION) {return null;}
+    if (!raw.servers || typeof raw.servers !== "object") {return null;}
     return raw as MetadataCache;
   } catch {
     return null;
@@ -105,9 +105,9 @@ export function isServerCacheValid(
   definition: ServerEntry,
   maxAgeMs: number = CACHE_MAX_AGE_MS
 ): boolean {
-  if (!entry || entry.configHash !== computeServerHash(definition)) return false;
-  if (!entry.cachedAt || typeof entry.cachedAt !== "number") return false;
-  if (maxAgeMs > 0 && Date.now() - entry.cachedAt > maxAgeMs) return false;
+  if (!entry || entry.configHash !== computeServerHash(definition)) {return false;}
+  if (!entry.cachedAt || typeof entry.cachedAt !== "number") {return false;}
+  if (maxAgeMs > 0 && Date.now() - entry.cachedAt > maxAgeMs) {return false;}
   return true;
 }
 
@@ -120,7 +120,7 @@ export function reconstructToolMetadata(
   const metadata: ToolMetadata[] = [];
 
   for (const tool of entry.tools ?? []) {
-    if (!tool?.name) continue;
+    if (!tool?.name) {continue;}
     metadata.push({
       name: formatToolName(tool.name, serverName, prefix),
       originalName: tool.name,
@@ -133,7 +133,7 @@ export function reconstructToolMetadata(
 
   if (exposeResources !== false) {
     for (const resource of entry.resources ?? []) {
-      if (!resource?.name || !resource?.uri) continue;
+      if (!resource?.name || !resource?.uri) {continue;}
       const baseName = `get_${resourceNameToToolName(resource.name)}`;
       metadata.push({
         name: formatToolName(baseName, serverName, prefix),

package/resources/pi-agent/extensions/pi-mcp-adapter/npx-resolver.ts

@@ -42,7 +42,7 @@ export async function resolveNpxBinary(
       ? parseNpmExecArgs(args)
       : null;
 
-  if (!parsed) return null;
+  if (!parsed) {return null;}
 
   const cacheKey = JSON.stringify([command, ...args]);
   const cache = loadCache();
@@ -85,19 +85,19 @@ function parseNpxArgs(args: string[]): ParsedInvocation | null {
       positionals.push(arg);
       continue;
     }
-    if (arg === "-y" || arg === "--yes") continue;
+    if (arg === "-y" || arg === "--yes") {continue;}
     if (arg === "-p" || arg === "--package") {
       const value = before[i + 1];
-      if (!value || value.startsWith("-")) return null;
-      if (!packageSpec) packageSpec = value;
+      if (!value || value.startsWith("-")) {return null;}
+      if (!packageSpec) {packageSpec = value;}
       sawPackageFlag = true;
       i++;
       continue;
     }
     if (arg.startsWith("--package=")) {
       const value = arg.slice("--package=".length);
-      if (!value) return null;
-      if (!packageSpec) packageSpec = value;
+      if (!value) {return null;}
+      if (!packageSpec) {packageSpec = value;}
       sawPackageFlag = true;
       continue;
     }
@@ -110,22 +110,22 @@ function parseNpxArgs(args: string[]): ParsedInvocation | null {
 
   if (sawPackageFlag) {
     const binName = positionals[0];
-    if (!packageSpec || !binName) return null;
+    if (!packageSpec || !binName) {return null;}
     const extraArgs = positionals.slice(1).concat(after);
     return { packageSpec, binName, extraArgs };
   }
 
   const packagePositional = positionals[0];
-  if (!packagePositional) return null;
+  if (!packagePositional) {return null;}
   const extraArgs = positionals.slice(1).concat(after);
   return { packageSpec: packagePositional, extraArgs };
 }
 
 function parseNpmExecArgs(args: string[]): ParsedInvocation | null {
-  if (args[0] !== "exec") return null;
+  if (args[0] !== "exec") {return null;}
   const execArgs = args.slice(1);
   const separatorIndex = execArgs.indexOf("--");
-  if (separatorIndex < 0) return null;
+  if (separatorIndex < 0) {return null;}
 
   const before = execArgs.slice(0, separatorIndex);
   const after = execArgs.slice(separatorIndex + 1);
@@ -133,18 +133,18 @@ function parseNpmExecArgs(args: string[]): ParsedInvocation | null {
   let packageSpec: string | undefined;
   for (let i = 0; i < before.length; i++) {
     const arg = before[i];
-    if (arg === "-y" || arg === "--yes") continue;
+    if (arg === "-y" || arg === "--yes") {continue;}
     if (arg === "--package") {
       const value = before[i + 1];
-      if (!value || value.startsWith("-")) return null;
-      if (!packageSpec) packageSpec = value;
+      if (!value || value.startsWith("-")) {return null;}
+      if (!packageSpec) {packageSpec = value;}
       i++;
       continue;
     }
     if (arg.startsWith("--package=")) {
       const value = arg.slice("--package=".length);
-      if (!value) return null;
-      if (!packageSpec) packageSpec = value;
+      if (!value) {return null;}
+      if (!packageSpec) {packageSpec = value;}
       continue;
     }
     if (arg.startsWith("-")) {
@@ -153,23 +153,23 @@ function parseNpmExecArgs(args: string[]): ParsedInvocation | null {
   }
 
   const binName = after[0];
-  if (!packageSpec || !binName) return null;
+  if (!packageSpec || !binName) {return null;}
   const extraArgs = after.slice(1);
   return { packageSpec, binName, extraArgs };
 }
 
 function resolveFromNpmCache(packageSpec: string, binName?: string): NpxCacheEntry | null {
   const cacheDir = getNpmCacheDir();
-  if (!cacheDir) return null;
+  if (!cacheDir) {return null;}
 
   const packageName = extractPackageName(packageSpec);
-  if (!packageName) return null;
+  if (!packageName) {return null;}
 
   const packageDir = findCachedPackageDir(cacheDir, packageName);
-  if (!packageDir) return null;
+  if (!packageDir) {return null;}
 
   const packageJsonPath = join(packageDir, "package.json");
-  if (!existsSync(packageJsonPath)) return null;
+  if (!existsSync(packageJsonPath)) {return null;}
 
   let pkg: { bin?: string | Record<string, string>; version?: string } | null = null;
   try {
@@ -182,7 +182,7 @@ function resolveFromNpmCache(packageSpec: string, binName?: string): NpxCacheEnt
   }
 
   const binField = pkg?.bin;
-  if (!binField) return null;
+  if (!binField) {return null;}
 
   const candidates = buildBinCandidates(packageName, binName);
   let chosenBinName: string | undefined;
@@ -208,14 +208,14 @@ function resolveFromNpmCache(packageSpec: string, binName?: string): NpxCacheEnt
     }
   }
 
-  if (!binRel) return null;
+  if (!binRel) {return null;}
 
   const nodeModulesDir = findNodeModulesDir(packageDir);
   const binLink = chosenBinName ? join(nodeModulesDir, ".bin", chosenBinName) : null;
   let resolvedBin = binLink && existsSync(binLink) ? safeRealpath(binLink) : "";
   if (!resolvedBin) {
     resolvedBin = resolve(packageDir, binRel);
-    if (!existsSync(resolvedBin)) return null;
+    if (!existsSync(resolvedBin)) {return null;}
   }
 
   const isJs = detectJsBinary(resolvedBin);
@@ -252,13 +252,13 @@ async function forceNpxCache(packageSpec: string): Promise<void> {
 
 function buildBinCandidates(packageName: string, explicitBin?: string): string[] {
   const candidates: string[] = [];
-  if (explicitBin) candidates.push(explicitBin);
+  if (explicitBin) {candidates.push(explicitBin);}
 
   if (packageName.startsWith("@")) {
     const namePart = packageName.split("/")[1] ?? "";
     const scopePart = packageName.split("/")[0]?.replace("@", "") ?? "";
-    if (namePart) candidates.push(namePart);
-    if (scopePart && namePart) candidates.push(`${scopePart}-${namePart}`);
+    if (namePart) {candidates.push(namePart);}
+    if (scopePart && namePart) {candidates.push(`${scopePart}-${namePart}`);}
   } else {
     candidates.push(packageName);
   }
@@ -268,10 +268,10 @@ function buildBinCandidates(packageName: string, explicitBin?: string): string[]
 
 function extractPackageName(spec: string): string | null {
   const trimmed = spec.trim();
-  if (!trimmed) return null;
+  if (!trimmed) {return null;}
   if (trimmed.startsWith("@")) {
     const slashIndex = trimmed.indexOf("/");
-    if (slashIndex < 0) return null;
+    if (slashIndex < 0) {return null;}
     const atIndex = trimmed.lastIndexOf("@");
     if (atIndex > slashIndex) {
       return trimmed.slice(0, atIndex);
@@ -292,7 +292,7 @@ function defaultBinName(packageName: string): string {
 
 function findCachedPackageDir(cacheDir: string, packageName: string): string | null {
   const npxDir = join(cacheDir, "_npx");
-  if (!existsSync(npxDir)) return null;
+  if (!existsSync(npxDir)) {return null;}
 
   const packagePathParts = packageName.startsWith("@")
     ? packageName.split("/")
@@ -328,7 +328,7 @@ function findNodeModulesDir(packageDir: string): string {
 
 function detectJsBinary(binPath: string): boolean {
   const ext = extname(binPath).toLowerCase();
-  if (ext === ".js" || ext === ".mjs" || ext === ".cjs") return true;
+  if (ext === ".js" || ext === ".mjs" || ext === ".cjs") {return true;}
   try {
     const fd = openSync(binPath, "r");
     try {
@@ -347,7 +347,7 @@ function detectJsBinary(binPath: string): boolean {
 let npmCacheDirCached: string | null | undefined;
 
 function getNpmCacheDir(): string | null {
-  if (npmCacheDirCached !== undefined) return npmCacheDirCached;
+  if (npmCacheDirCached !== undefined) {return npmCacheDirCached;}
   if (process.env.NPM_CONFIG_CACHE) {
     npmCacheDirCached = process.env.NPM_CONFIG_CACHE;
     return npmCacheDirCached;
@@ -368,12 +368,12 @@ function getNpmCacheDir(): string | null {
 }
 
 function loadCache(): NpxCache | null {
-  if (!existsSync(CACHE_PATH)) return null;
+  if (!existsSync(CACHE_PATH)) {return null;}
   try {
     const raw = JSON.parse(readFileSync(CACHE_PATH, "utf-8"));
-    if (!raw || typeof raw !== "object") return null;
-    if (raw.version !== CACHE_VERSION) return null;
-    if (!raw.entries || typeof raw.entries !== "object") return null;
+    if (!raw || typeof raw !== "object") {return null;}
+    if (raw.version !== CACHE_VERSION) {return null;}
+    if (!raw.entries || typeof raw.entries !== "object") {return null;}
     return raw as NpxCache;
   } catch {
     return null;

package/resources/pi-agent/extensions/pi-mcp-adapter/oauth-handler.ts

@@ -26,7 +26,7 @@ function getTokensPath(serverName: string): string {
 export function getStoredTokens(serverName: string): OAuthTokens | undefined {
   const tokensPath = getTokensPath(serverName);
   
-  if (!existsSync(tokensPath)) return undefined;
+  if (!existsSync(tokensPath)) {return undefined;}
   
   try {
     const stored = JSON.parse(readFileSync(tokensPath, "utf-8"));

package/resources/pi-agent/extensions/pi-mcp-adapter/proxy-modes.ts

@@ -217,7 +217,7 @@ export function executeSearch(
   if (!server && getPiTools) {
     const piTools = getPiTools();
     for (const tool of piTools) {
-      if (tool.name === "mcp") continue;
+      if (tool.name === "mcp") {continue;}
 
       if (pattern.test(tool.name) || pattern.test(tool.description ?? "")) {
         piMatches.push({
@@ -229,7 +229,7 @@ export function executeSearch(
   }
 
   for (const [serverName, metadata] of state.toolMetadata.entries()) {
-    if (server && serverName !== server) continue;
+    if (server && serverName !== server) {continue;}
     for (const tool of metadata) {
       if (pattern.test(tool.name) || pattern.test(tool.description)) {
         matches.push({
@@ -347,7 +347,7 @@ export function executeList(state: McpExtensionState, server: string): ProxyTool
     const desc = descMap.get(tool) ?? "";
     const truncated = truncateAtWord(desc, 50);
     text += `- ${tool}`;
-    if (truncated) text += ` - ${truncated}`;
+    if (truncated) {text += ` - ${truncated}`;}
     text += "\n";
   }
 
@@ -444,10 +444,10 @@ export async function executeCall(
 
     for (const { name: configuredServer } of candidates) {
       const failedAgo = getFailureAgeSeconds(state, configuredServer);
-      if (failedAgo !== null) continue;
+      if (failedAgo !== null) {continue;}
       const connected = await lazyConnect(state, configuredServer);
-      if (!connected) continue;
-      if (!prefixMatchedServer) prefixMatchedServer = configuredServer;
+      if (!connected) {continue;}
+      if (!prefixMatchedServer) {prefixMatchedServer = configuredServer;}
       toolMeta = findToolByName(state.toolMetadata.get(configuredServer), toolName);
       if (toolMeta) {
         serverName = configuredServer;
@@ -540,12 +540,12 @@ export async function executeCall(
 
     uiSession = toolMeta.uiResourceUri
       ? await maybeStartUiSession(state, {
-          serverName,
-          toolName: toolMeta.originalName,
-          toolArgs: args ?? {},
-          uiResourceUri: toolMeta.uiResourceUri,
-          streamMode: toolMeta.uiStreamMode,
-        })
+        serverName,
+        toolName: toolMeta.originalName,
+        toolArgs: args ?? {},
+        uiResourceUri: toolMeta.uiResourceUri,
+        streamMode: toolMeta.uiStreamMode,
+      })
       : null;
 
     const resultPromise = connection.client.callTool({

package/resources/pi-agent/extensions/pi-mcp-adapter/server-manager.ts

@@ -206,7 +206,7 @@ export class McpServerManager {
   private attachAdapterNotificationHandlers(serverName: string, client: Client): void {
     client.setNotificationHandler(serverStreamResultPatchNotificationSchema, (notification) => {
       const listener = this.uiStreamListeners.get(notification.params.streamToken);
-      if (!listener) return;
+      if (!listener) {return;}
       listener(serverName, notification.params);
     });
   }
@@ -237,7 +237,7 @@ export class McpServerManager {
   
   async close(name: string): Promise<void> {
     const connection = this.connections.get(name);
-    if (!connection) return;
+    if (!connection) {return;}
     
     // Delete from map BEFORE async cleanup to prevent a race where a
     // concurrent connect() creates a new connection that our deferred
@@ -284,8 +284,8 @@ export class McpServerManager {
 
   isIdle(name: string, timeoutMs: number): boolean {
     const connection = this.connections.get(name);
-    if (!connection || connection.status !== "connected") return false;
-    if (connection.inFlight > 0) return false;
+    if (!connection || connection.status !== "connected") {return false;}
+    if (connection.inFlight > 0) {return false;}
     return (Date.now() - connection.lastUsedAt) > timeoutMs;
   }
 }
@@ -302,7 +302,7 @@ function resolveEnv(env?: Record<string, string>): Record<string, string> {
     }
   }
   
-  if (!env) return resolved;
+  if (!env) {return resolved;}
   
   for (const [key, value] of Object.entries(env)) {
     // Support ${VAR} and $env:VAR interpolation
@@ -318,7 +318,7 @@ function resolveEnv(env?: Record<string, string>): Record<string, string> {
  * Resolve headers with environment variable interpolation.
  */
 function resolveHeaders(headers?: Record<string, string>): Record<string, string> | undefined {
-  if (!headers) return undefined;
+  if (!headers) {return undefined;}
   
   const resolved: Record<string, string> = {};
   for (const [key, value] of Object.entries(headers)) {

package/resources/pi-agent/extensions/pi-mcp-adapter/tool-metadata.ts

@@ -64,9 +64,9 @@ export function totalToolCount(state: McpExtensionState): number {
 }
 
 export function findToolByName(metadata: ToolMetadata[] | undefined, toolName: string): ToolMetadata | undefined {
-  if (!metadata) return undefined;
+  if (!metadata) {return undefined;}
   const exact = metadata.find(m => m.name === toolName);
-  if (exact) return exact;
+  if (exact) {return exact;}
   const normalized = toolName.replace(/-/g, "_");
   return metadata.find(m => m.name.replace(/-/g, "_") === normalized);
 }
@@ -129,8 +129,8 @@ function formatProperty(name: string, schema: unknown, required: boolean, indent
   }
 
   parts.push(`${indent}${name}`);
-  if (typeStr) parts.push(`(${typeStr})`);
-  if (required) parts.push("*required*");
+  if (typeStr) {parts.push(`(${typeStr})`);}
+  if (required) {parts.push("*required*");}
 
   if (s.description && typeof s.description === "string") {
     parts.push(`- ${s.description}`);

package/resources/pi-agent/extensions/pi-mcp-adapter/types.ts

@@ -345,10 +345,10 @@ export function getServerPrefix(
   serverName: string,
   mode: "server" | "none" | "short"
 ): string {
-  if (mode === "none") return "";
+  if (mode === "none") {return "";}
   if (mode === "short") {
     let short = serverName.replace(/-?mcp$/i, "").replace(/-/g, "_");
-    if (!short) short = "mcp";
+    if (!short) {short = "mcp";}
     return short;
   }
   return serverName.replace(/-/g, "_");

package/resources/pi-agent/extensions/pi-mcp-adapter/ui-resource-handler.ts

@@ -80,9 +80,9 @@ export class UiResourceHandler {
 
   private getListResourceMeta(serverName: string, uri: string): Record<string, unknown> | undefined {
     const connection = this.manager.getConnection(serverName);
-    if (!connection?.resources?.length) return undefined;
+    if (!connection?.resources?.length) {return undefined;}
     const resource = connection.resources.find((entry) => entry.uri === uri);
-    if (!resource || !resource._meta || typeof resource._meta !== "object") return undefined;
+    if (!resource || !resource._meta || typeof resource._meta !== "object") {return undefined;}
     return resource._meta;
   }
 }
@@ -94,12 +94,12 @@ function selectContent(result: ReadResourceResult, preferredUri: string): Resour
   }
 
   const byUri = contents.find((content) => content.uri === preferredUri);
-  if (byUri) return byUri;
+  if (byUri) {return byUri;}
 
   const byHtmlMime = contents.find(
     (content) => content.mimeType && isHtmlMimeType(content.mimeType)
   );
-  if (byHtmlMime) return byHtmlMime;
+  if (byHtmlMime) {return byHtmlMime;}
 
   return contents[0];
 }
@@ -122,9 +122,9 @@ function toHtml(content: ResourceContentRecord): string {
 }
 
 function extractUiMeta(meta: Record<string, unknown> | undefined): UiResourceMeta {
-  if (!meta || typeof meta !== "object") return {};
+  if (!meta || typeof meta !== "object") {return {};}
   const ui = meta.ui as Record<string, unknown> | undefined;
-  if (!ui || typeof ui !== "object") return {};
+  if (!ui || typeof ui !== "object") {return {};}
 
   const out: UiResourceMeta = {};
 

package/resources/pi-agent/extensions/pi-mcp-adapter/ui-server.ts

@@ -123,7 +123,7 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
 
   const updateStreamSummary = (payload: unknown) => {
     const envelope = getVisualizationStreamEnvelope((payload as { structuredContent?: unknown } | null)?.structuredContent);
-    if (!envelope) return;
+    if (!envelope) {return;}
     if (!streamSummary) {
       streamSummary = {
         streamId: envelope.streamId,
@@ -156,7 +156,7 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
   };
 
   const pruneEventLog = () => {
-    if (eventLog.length <= MAX_EVENT_LOG) return;
+    if (eventLog.length <= MAX_EVENT_LOG) {return;}
     const latestCheckpointIndex = getLatestCheckpointIndex();
 
     if (latestCheckpointIndex > 0) {
@@ -169,7 +169,7 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
   };
 
   const pushEvent = (name: string, payload: unknown) => {
-    if (completed) return;
+    if (completed) {return;}
     const eventId = nextEventId++;
     eventLog.push({ id: eventId, name, payload });
     updateStreamSummary(payload);
@@ -189,9 +189,9 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
     const eventsToReplay = Number.isFinite(parsedLastId)
       ? eventLog.filter((entry) => entry.id > parsedLastId)
       : (() => {
-          const latestCheckpointIndex = getLatestCheckpointIndex();
-          return latestCheckpointIndex >= 0 ? eventLog.slice(latestCheckpointIndex) : eventLog;
-        })();
+        const latestCheckpointIndex = getLatestCheckpointIndex();
+        return latestCheckpointIndex >= 0 ? eventLog.slice(latestCheckpointIndex) : eventLog;
+      })();
 
     for (const entry of eventsToReplay) {
       try {
@@ -213,13 +213,13 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
   };
 
   const stopWatchdog = () => {
-    if (!watchdog) return;
+    if (!watchdog) {return;}
     clearInterval(watchdog);
     watchdog = null;
   };
 
   const markCompleted = (reason: string) => {
-    if (completed) return;
+    if (completed) {return;}
     log.debug("Session completed", { reason });
     pushEvent("session-complete", { reason });
     completed = true;
@@ -227,13 +227,13 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
     options.onComplete?.(reason);
   };
 
-  const server = http.createServer(async (req, res) => {
+  const server = http.createServer(async(req, res) => {
     try {
       const method = req.method || "GET";
       const url = new URL(req.url || "/", `http://${req.headers.host || "127.0.0.1"}`);
 
       if (method === "GET" && url.pathname === "/") {
-        if (!validateTokenQuery(url, sessionToken, res)) return;
+        if (!validateTokenQuery(url, sessionToken, res)) {return;}
         touchHeartbeat();
 
         const html = buildHostHtmlTemplate({
@@ -257,7 +257,7 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
       }
 
       if (method === "GET" && url.pathname === "/events") {
-        if (!validateTokenQuery(url, sessionToken, res)) return;
+        if (!validateTokenQuery(url, sessionToken, res)) {return;}
         touchHeartbeat();
         log.debug("SSE client connected", { clientCount: sseClients.size + 1 });
         res.writeHead(200, {
@@ -276,13 +276,13 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
       }
 
       if (method === "GET" && url.pathname === "/health") {
-        if (!validateTokenQuery(url, sessionToken, res)) return;
+        if (!validateTokenQuery(url, sessionToken, res)) {return;}
         sendJson(res, 200, { ok: true, result: { healthy: true } });
         return;
       }
 
       if (method === "GET" && url.pathname === "/ui-app") {
-        if (!validateTokenQuery(url, sessionToken, res)) return;
+        if (!validateTokenQuery(url, sessionToken, res)) {return;}
         touchHeartbeat();
         // Serve the MCP app's UI HTML directly (avoids blob URL security issues)
         // Apply CSP meta tag if specified in resource metadata
@@ -318,8 +318,8 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
       }
 
       const body = await parseBody(req, res);
-      if (!body) return;
-      if (!validateTokenBody(body, sessionToken, res)) return;
+      if (!body) {return;}
+      if (!validateTokenBody(body, sessionToken, res)) {return;}
       const params = body.params ?? {};
       touchHeartbeat();
 
@@ -478,8 +478,8 @@ export async function startUiServer(options: UiServerOptions): Promise<UiServerH
   }
 
   watchdog = setInterval(() => {
-    if (completed) return;
-    if (Date.now() - lastHeartbeatAt <= ABANDONED_GRACE_MS) return;
+    if (completed) {return;}
+    if (Date.now() - lastHeartbeatAt <= ABANDONED_GRACE_MS) {return;}
     markCompleted("stale");
     try {
       server.close();