@adhdev/daemon-standalone 0.9.76-rc.59 → 0.9.76-rc.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-standalone",
-  "version": "0.9.76-rc.59",
+  "version": "0.9.76-rc.60",
   "description": "ADHDev standalone daemon — embedded HTTP/WS server for local dashboard",
   "main": "dist/index.js",
   "bin": {

package/vendor/mcp-server/index.js

@@ -40182,7 +40182,7 @@ var init_dist2 = __esm({
    b. If you need branch isolation for parallel work, call \`mesh_clone_node\` to create a worktree node first.
    c. If no session exists, call \`mesh_launch_session\` to start one.
    d. Call \`mesh_send_task\` with a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
-4. **Monitor** \u2014 Prefer event-driven completion/status notifications. Do **not** poll \`mesh_read_chat\` repeatedly just because the delegated session has not produced a final assistant message yet; tool/terminal activity means work may still be in progress. Use at most one compact \`mesh_read_chat\` check after a completion/approval signal, an explicit user status request, or a real timeout/stall. Handle approvals via \`mesh_approve\`.
+4. **Monitor** \u2014 Prefer event-driven completion/status notifications. Do **not** poll \`mesh_read_chat\` repeatedly just because the delegated session has not produced a final assistant message yet; tool/terminal activity means work may still be in progress. Do not call \`mesh_read_chat\` again within a few seconds for the same generating session; wait for the completion callback/status event instead unless you are debugging a real stall. Use at most one compact \`mesh_read_chat\` check after a completion/approval signal, an explicit user status request, or a real timeout/stall. Handle approvals via \`mesh_approve\`.
 5. **Verify** \u2014 When a task reports completion or git work is visible, call \`mesh_git_status\` to verify changes were made.
 6. **Checkpoint** \u2014 Call \`mesh_checkpoint\` to save the work.
 7. **Clean up** \u2014 Remove worktree nodes via \`mesh_remove_node\` after their work is merged or no longer needed.
@@ -56131,6 +56131,46 @@ function compactChatPayload(payload, opts = {}) {
   };
 }
 
+// src/tools/read-chat-polling-advisory.ts
+var RAPID_READ_CHAT_ADVISORY_WINDOW_MS = 5e3;
+var ACTIVE_READ_STATUSES = /* @__PURE__ */ new Set([
+  "generating",
+  "running",
+  "streaming",
+  "starting",
+  "busy"
+]);
+var recentReads = /* @__PURE__ */ new Map();
+function isActiveReadChatStatus(status) {
+  return typeof status === "string" && ACTIVE_READ_STATUSES.has(status.toLowerCase());
+}
+function annotateRapidReadChatAdvisory(payload, options) {
+  const now = options.now ?? Date.now();
+  const status = options.status ?? payload?.status ?? payload?.data?.status ?? payload?.result?.status;
+  const active = isActiveReadChatStatus(status);
+  const previous = recentReads.get(options.key);
+  if (!active) {
+    recentReads.set(options.key, { at: now, status: typeof status === "string" ? status : void 0 });
+    return payload;
+  }
+  recentReads.set(options.key, { at: now, status: typeof status === "string" ? status : void 0 });
+  if (!previous || !isActiveReadChatStatus(previous.status)) return payload;
+  const elapsedMs = now - previous.at;
+  if (elapsedMs < 0 || elapsedMs >= RAPID_READ_CHAT_ADVISORY_WINDOW_MS) return payload;
+  return {
+    ...payload,
+    pollingAdvisory: {
+      type: "rapid_read_chat_polling",
+      toolName: options.toolName,
+      windowMs: RAPID_READ_CHAT_ADVISORY_WINDOW_MS,
+      elapsedMs,
+      nextSuggestedReadAt: previous.at + RAPID_READ_CHAT_ADVISORY_WINDOW_MS,
+      completionCallbackExpected: Boolean(options.completionCallbackExpected),
+      message: `This session is still ${String(status)}. Avoid repeated ${options.toolName} polling for the same generating session; wait for the completion callback/status event or retry after the suggested time if you are debugging a real stall.`
+    }
+  };
+}
+
 // src/tools/read-chat.ts
 var READ_CHAT_TOOL = {
   name: "read_chat",
@@ -56166,12 +56206,22 @@ async function readChat(transport, args) {
       ...args.session_id ? { targetSessionId: args.session_id } : {},
       tailLimit: limit
     });
-    return formatChatResult(result2, args.session_id, args.format, limit, args.compact);
+    const annotated2 = annotateRapidReadChatAdvisory(result2, {
+      key: `local:${args.session_id ?? "__active__"}`,
+      toolName: "read_chat",
+      completionCallbackExpected: false
+    });
+    return formatChatResult(annotated2, args.session_id, args.format, limit, args.compact);
   }
   if (!args.daemon_id) throw new Error("daemon_id is required in cloud mode");
   const targetId = args.session_id ? `${args.daemon_id}:session:${args.session_id}` : args.daemon_id;
   const result = await transport.readChat(targetId, { limit, sessionId: args.session_id });
-  return formatChatResult(result, args.session_id, args.format, limit, args.compact);
+  const annotated = annotateRapidReadChatAdvisory(result, {
+    key: `cloud:${args.daemon_id}:${args.session_id ?? "__active__"}`,
+    toolName: "read_chat",
+    completionCallbackExpected: false
+  });
+  return formatChatResult(annotated, args.session_id, args.format, limit, args.compact);
 }
 function formatChatResult(result, sessionId, format, limit = 50, compact = false) {
   if (!result?.success && result?.error) {
@@ -56187,6 +56237,7 @@ function formatChatResult(result, sessionId, format, limit = 50, compact = false
       return JSON.stringify({
         session_id: sessionId ?? null,
         ...compactPayload,
+        ...result?.pollingAdvisory ? { pollingAdvisory: result.pollingAdvisory } : {},
         messages: compactPayload.messages.map((m) => ({
           role: m.role,
           kind: m.kind ?? null,
@@ -56197,6 +56248,7 @@ function formatChatResult(result, sessionId, format, limit = 50, compact = false
     }
     return JSON.stringify({
       session_id: sessionId ?? null,
+      ...result?.pollingAdvisory ? { pollingAdvisory: result.pollingAdvisory } : {},
       messages: outputMessages.slice(-limit).map((m) => ({
         role: m.role,
         kind: m.kind ?? null,
@@ -56205,13 +56257,20 @@ function formatChatResult(result, sessionId, format, limit = 50, compact = false
       }))
     }, null, 2);
   }
-  if (outputMessages.length === 0) return "No messages in chat.";
+  if (outputMessages.length === 0) {
+    return result?.pollingAdvisory ? `No messages in chat.
+
+Advisory: ${result.pollingAdvisory.message}` : "No messages in chat.";
+  }
   const lines = outputMessages.slice(-limit).map((m) => {
     const role = m.role === "user" ? "User" : m.role === "assistant" ? "Agent" : m.role;
     const content = messageContent(m);
     const truncated = content.length > 500 ? `${content.slice(0, 500)}\u2026` : content;
     return `[${role}] ${truncated}`;
   });
+  if (result?.pollingAdvisory) {
+    lines.push(`Advisory: ${result.pollingAdvisory.message}`);
+  }
   return lines.join("\n\n");
 }
 
@@ -57544,13 +57603,22 @@ async function meshReadChat(ctx, args) {
       ...providerSessionId ? { providerSessionId } : {},
       tailLimit: args.tail ?? 10
     });
-    const payload = unwrapCommandPayload(result);
+    const payload = annotateRapidReadChatAdvisory(unwrapCommandPayload(result), {
+      key: `mesh:${args.node_id}:${args.session_id}`,
+      toolName: "mesh_read_chat",
+      completionCallbackExpected: true
+    });
     if (args.compact) {
-      return JSON.stringify(compactChatPayload(payload, {
+      const compactPayload = compactChatPayload(payload, {
         nodeId: args.node_id,
         sessionId: args.session_id,
         limit: args.tail ?? 10
-      }), null, 2);
+      });
+      return JSON.stringify(
+        payload.pollingAdvisory ? { ...compactPayload, pollingAdvisory: payload.pollingAdvisory } : compactPayload,
+        null,
+        2
+      );
     }
     return JSON.stringify(payload, null, 2);
   } else {