@yeaft/webchat-agent 0.1.848 → 0.1.849

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.848",
+  "version": "0.1.849",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/unify/dream-v2/apply.js

@@ -228,7 +228,23 @@ export async function applyMergedTarget(merged, opts) {
   await writeMemory(scope, stamped, { root: opts.root });
   await writeSummary(scope, summaryMd || '', { root: opts.root, language: opts.language });
 
-  if (opts.onProgress) opts.onProgress({ phase: 'apply', target: merged.target, status: 'done', batches: batchesUsed });
+  if (opts.onProgress) {
+    // feat-dream-debug-detail: surface a truncated copy of what was
+    // actually written so the debug panel can show "what segments were
+    // generated" instead of just "done". The full bytes are on disk
+    // anyway — this preview is for at-a-glance debugging.
+    opts.onProgress({
+      phase: 'apply',
+      target: merged.target,
+      status: 'done',
+      batches: batchesUsed,
+      kind: merged.kind,
+      memoryMdPreview: truncateForDebug(stamped),
+      summaryMdPreview: truncateForDebug(summaryMd || ''),
+      memoryMdLength: (stamped || '').length,
+      summaryMdLength: (summaryMd || '').length,
+    });
+  }
   return { target: merged.target, kind: merged.kind, batches: batchesUsed };
 }
 
@@ -246,3 +262,23 @@ function scopeRelDir(scope) {
 }
 
 function oneLine(s) { return String(s || '').replace(/\s+/g, ' ').trim().slice(0, 200); }
+
+/**
+ * Per-field truncation cap for debug previews emitted on `apply/done`.
+ * Keep this small — the dream panel only needs a recognisable snippet.
+ * Total worst-case payload is `PREVIEW_MAX * 2 * targets_per_run` per
+ * dream pass; with N=50 targets that's ~200 KB. The full bytes are on
+ * disk under <root>/<scope>/{memory,summary}.md anyway — these previews
+ * are for at-a-glance debugging only.
+ */
+const PREVIEW_MAX = 2048;
+
+/**
+ * Truncate a markdown blob for inclusion in a debug-panel cell. Adds a
+ * "…(+N chars)" marker so the user knows it was cut.
+ */
+function truncateForDebug(s, max = PREVIEW_MAX) {
+  const str = String(s || '');
+  if (str.length <= max) return str;
+  return str.slice(0, max) + `…(+${str.length - max} chars)`;
+}

package/unify/dream-v2/session-wiring.js

@@ -7,6 +7,35 @@
  *
  * Memory v2 is the only path. The legacy `config.memoryV2` opt-out flag was
  * retired (task-710) — the wiring is unconditional.
+ *
+ * ─────────────────────────────────────────────────────────────────────
+ * Wire contract — DreamEvent (consumed by web/components/UnifyDebugPanel.js)
+ * ─────────────────────────────────────────────────────────────────────
+ * The events persisted to trace_events with these event_type values are
+ * load-bearing for the debug panel. Renaming a field on this side
+ * silently degrades that UI to a generic JSON dump.
+ *
+ *   dream_turn_open:   { type:'turn_open',  turnId, userPrompt, vpId, groupId, at }
+ *   dream_loop:        { type:'loop',       turnId, loopNumber, pass, model,
+ *                        systemPrompt: string,
+ *                        messages: [{ role:'user', content:string }],
+ *                        response: string,
+ *                        toolCalls: [], usage: { inputTokens, outputTokens, totalTokens },
+ *                        latencyMs, ttfbMs, stopReason, rawRequest, rawResponse }
+ *   dream_turn_close:  { type:'turn_close', turnId, totalMs, totalTokens, loopCount,
+ *                        metrics: { llmCallCount, inputTokens, outputTokens,
+ *                                   totalTokens, durationMs, passBreakdown:{[pass]:{
+ *                                     llmCallCount, inputTokens, outputTokens,
+ *                                     totalTokens, durationMs }} } }
+ *   dream_run:         { type:'dream_run',  turnId, phase:'result',
+ *                        status:'done'|'error', metrics, resultSummary:{ groups,
+ *                        targets, error, skipped, skippedReason } }
+ *   dream_progress:    runner-emitted phase events (`start`/`load-diff`/`triage`/
+ *                      `merge`/`apply`/`done`). The `apply/done` variant carries
+ *                      `kind, memoryMdPreview, summaryMdPreview, memoryMdLength,
+ *                      summaryMdLength` (see apply.js).
+ *
+ * `groupId` may be inherited via `stampDreamScope()` when a scope is active.
  */
 
 import { join } from 'path';