@yeaft/webchat-agent 1.0.476 → 1.0.478

package/local-runtime/server/context.js

@@ -181,6 +181,31 @@ export function registerYeaftDebugRequest({ agentId, requestId, sessionId, clien
   return true;
 }
 
+/**
+ * Advance one strictly ordered debug-detail chunk. The correlation is consumed
+ * only after the complete sequence arrives; each accepted frame renews its TTL.
+ */
+export function advanceYeaftDebugRequestChunk({ agentId, requestId, sessionId, chunkIndex, chunkCount }) {
+  if (!agentId || !requestId) return null;
+  const now = Date.now();
+  pruneYeaftDebugRequests(now);
+  const key = yeaftDebugRequestKey(agentId, requestId);
+  const pending = pendingYeaftDebugRequests.get(key);
+  if (!pending || (sessionId && pending.sessionId !== sessionId)) return null;
+  const expectedIndex = pending.nextChunkIndex ?? 0;
+  const expectedCount = pending.chunkCount ?? chunkCount;
+  if (chunkIndex !== expectedIndex || chunkCount !== expectedCount) {
+    pendingYeaftDebugRequests.delete(key);
+    return null;
+  }
+  pending.nextChunkIndex = expectedIndex + 1;
+  pending.chunkCount = chunkCount;
+  pending.expiresAt = now + YEAFT_DEBUG_REQUEST_TTL_MS;
+  const complete = pending.nextChunkIndex === chunkCount;
+  if (complete) pendingYeaftDebugRequests.delete(key);
+  return { pending, complete };
+}
+
 /**
  * Consume a matching, unexpired correlation exactly once.
  * @param {{agentId:string, requestId:string, sessionId?:string|null}} response

package/local-runtime/server/handlers/agent-output.js

@@ -2,7 +2,7 @@ import { randomUUID } from 'crypto';
 import { messageDb, sessionUiMetadataDb, yeaftProjectDb, yeaftSessionDb } from '../database.js';
 import { transaction } from '../db/connection.js';
 import { broadcastAgentList, broadcastSessionCatalog, forwardToClients, sendToAgent, sendToWebClient } from '../ws-utils.js';
-import { consumeYeaftDebugRequest, webClients, previewFiles } from '../context.js';
+import { advanceYeaftDebugRequestChunk, consumeYeaftDebugRequest, webClients, previewFiles } from '../context.js';
 import { CONFIG } from '../config.js';
 import { yeaftAssetStore } from '../yeaft-asset-store.js';
 import { recordPerfTraceEvent } from '../perf-trace.js';
@@ -1021,6 +1021,34 @@ export async function handleAgentOutput(agentId, agent, msg) {
       break;
     }
 
+    case 'yeaft_debug_history_chunk': {
+      const chunkIndex = Number(msg.chunkIndex);
+      const chunkCount = Number(msg.chunkCount);
+      const validChunk = Number.isSafeInteger(chunkIndex) && Number.isSafeInteger(chunkCount)
+        && chunkCount > 1 && chunkIndex >= 0 && chunkIndex < chunkCount
+        && typeof msg.data === 'string' && Buffer.byteLength(msg.data, 'utf8') <= 512 * 1024;
+      if (!validChunk) break;
+      // Advance only a strict 0..N-1 sequence. An out-of-order "final" frame
+      // cannot consume a valid request, and every accepted frame renews the TTL.
+      const advanced = advanceYeaftDebugRequestChunk({
+        agentId, requestId: msg.requestId, sessionId: msg.sessionId,
+        chunkIndex, chunkCount,
+      });
+      const pending = advanced?.pending || null;
+      const targetClient = pending ? webClients.get(pending.clientId) : null;
+      const ownerMatches = CONFIG.skipAuth || (
+        pending?.userId === agent.ownerId && targetClient?.userId === pending.userId
+      );
+      if (targetClient?.authenticated && ownerMatches) {
+        await sendToWebClient(targetClient, {
+          type: 'yeaft_debug_history_chunk', agentId,
+          requestId: msg.requestId, sessionId: msg.sessionId,
+          chunkIndex, chunkCount, data: msg.data,
+        });
+      }
+      break;
+    }
+
     case 'yeaft_debug_history': {
       // Debug history is request/Turn scoped and may contain raw provider or
       // tool payloads. The Server registered this Agent + requestId after the

package/local-runtime/version.json

@@ -1 +1 @@
-{"version":"1.0.476"}
+{"version":"1.0.478"}