@yeaft/webchat-agent 1.0.347 → 1.0.349

package/yeaft/engine.js

@@ -1519,7 +1519,7 @@ export class Engine {
     return Boolean(this.#conversationStore) && !this.#config._readOnly;
   }
 
-  #conversationRecord(message, { sessionId, turnId, model, incomplete = false, stopReason = null } = {}) {
+  #conversationRecord(message, { sessionId, turnId, model, incomplete = false, stopReason = null, executionOrigin = null } = {}) {
     const record = {
       role: message.role,
       content: typeof message.content === 'string'
@@ -1545,6 +1545,9 @@ export class Engine {
       record.foldedMessageIds = [...message.foldedMessageIds];
     }
     if (turnId && (message.role === 'assistant' || message.role === 'tool')) record.turnId = turnId;
+    if (executionOrigin === 'route_forward' && (message.role === 'assistant' || message.role === 'tool')) {
+      record.executionOrigin = executionOrigin;
+    }
     if (this.#vpId && (message.role === 'assistant' || message.role === 'tool')) record.speakerVpId = this.#vpId;
     if (incomplete) record.incomplete = true;
     if (stopReason) record.stopReason = stopReason;
@@ -2117,6 +2120,9 @@ export class Engine {
     const runtimeThreadId = (typeof threadId === 'string' && threadId.trim())
       ? threadId.trim()
       : MAIN_THREAD_ID;
+    const executionOrigin = inboundEnvelope?.msg?.meta?.injectedBy === 'route_forward'
+      ? 'route_forward'
+      : null;
     const queryTurnId = randomUUID();
     const queryStartedAt = Date.now();
     const userQuestionPreview = String(prompt || '').slice(0, 200);
@@ -2615,6 +2621,7 @@ export class Engine {
           model: currentModel,
           incomplete: true,
           stopReason: reason,
+          executionOrigin,
         });
       };
       const toolCalls = [];
@@ -3363,6 +3370,7 @@ export class Engine {
         sessionId: runtimeSessionId,
         turnId: vpTurnId || queryTurnId,
         model: currentModel,
+        executionOrigin,
       });
       if (persistedAssistantMessage) {
         assistantMsg._persistedMessageId = persistedAssistantMessage.id;
@@ -3687,6 +3695,7 @@ export class Engine {
               count: pairs.length,
               originalUserMsg: prompt,
               originatingTurnId: queryTurnId,
+              executionOrigin,
               ready: false,
               result: null,
               error: null,
@@ -3973,6 +3982,7 @@ export class Engine {
           sessionId: runtimeSessionId,
           turnId: vpTurnId || queryTurnId,
           model: currentModel,
+          executionOrigin,
         });
         if (persistedToolMessage) {
           toolMessage._persistedMessageId = persistedToolMessage.id;
@@ -4110,7 +4120,7 @@ export class Engine {
             batchStart,
             batchEnd,
             reflectionMessage,
-            { sessionId: runtimeSessionId, model: currentModel },
+            { sessionId: runtimeSessionId, model: currentModel, executionOrigin },
           );
           if (durableRowsInRange && !persistedReflection) {
             throw new Error('T1 reflection could not publish its durable range replacement');
@@ -4303,7 +4313,10 @@ export class Engine {
         startIdx,
         endIdx,
         reflectionMessage,
-        context,
+        {
+          ...context,
+          executionOrigin: info.executionOrigin === 'route_forward' ? 'route_forward' : null,
+        },
       );
       if (durableRowsInRange && !persistedReflection) continue;
       // Mutate in place so caller's reference stays valid.

package/yeaft/router/continuity.js

@@ -86,7 +86,8 @@ export function extractPriorPlan(messages, vpId) {
 
 /**
  * Return a copy of the messages array with engine-private metadata stripped
- * from every message. The serialisers (anthropic/openai-responses) read this;
+ * from every message. This includes durable UI-only execution provenance.
+ * The serialisers (anthropic/openai-responses) read this;
  * these fields are NEVER part of the wire payload. Cheap because we only
  * shallow-clone the messages that actually have private fields.
  *
@@ -99,9 +100,17 @@ export function stripMetaForWire(messages) {
   const out = messages.map(m => {
     if (m && typeof m === 'object'
         && ('_meta' in m || '_runtimeTurnId' in m || '_partialTurn' in m
-          || '_persistedMessageId' in m || 'userAuthored' in m)) {
+          || '_persistedMessageId' in m || 'userAuthored' in m || 'executionOrigin' in m)) {
       mutated = true;
-      const { _meta, _runtimeTurnId, _partialTurn, _persistedMessageId, userAuthored, ...rest } = m;
+      const {
+        _meta,
+        _runtimeTurnId,
+        _partialTurn,
+        _persistedMessageId,
+        userAuthored,
+        executionOrigin,
+        ...rest
+      } = m;
       return rest;
     }
     return m;

package/yeaft/session.js

@@ -250,23 +250,12 @@ export async function loadSession(options = {}) {
   }
 
   // ─── 3. Create trajectory trace ─────────────────────────
-  // Always-on request trace for the Debug panel. It is file-backed, not
-  // SQLite-backed: each request writes one bounded JSON file under
-  // `<yeaftDir>/debug/` (session traces are nested under
-  // `<yeaftDir>/sessions/<sessionId>/debug/requests/`). A request file stores one
-  // base request snapshot plus per-loop deltas, so 100-200 loop requests do
-  // not become hundreds of tiny files or repeated cumulative payloads.
+  // Debug traces can contain prompts, tool payloads, and provider envelopes.
+  // Keep collection opt-in and avoid scanning trace history during Session boot.
   const trace = createTrace({
-    enabled: true,
+    enabled: config.debug === true,
     dirPath: yeaftDir,
   });
-  // Hard cap debug history to the most recent 10 requests per Session. Trace
-  // failures are best-effort and must never stop the agent loop. cleanup() is
-  // now async (it hydrates the in-memory index, then prunes); run it
-  // fire-and-forget so session load never blocks on the startup disk scan.
-  Promise.resolve(trace.cleanup?.(10)).catch((err) => {
-    console.warn('[Yeaft] trace.cleanup failed:', err?.message || err);
-  });
 
   // ─── 4. Create LLM adapter ────────────────────────────
   const adapter = withUsageAccounting(

package/yeaft/web-bridge.js

@@ -6440,7 +6440,13 @@ export async function handleYeaftFetchDebugHistory(msg = {}) {
   let dreamEvents = [];
   let hasMore = false;
   try {
-    if (session?.trace && typeof session.trace.fetchRecentDebugHistory === 'function') {
+    if (session?.trace && detailTurnId && sessionId && typeof session.trace.fetchTurnDebug === 'function') {
+      const out = await session.trace.fetchTurnDebug({ sessionId, turnId: detailTurnId, dreamLimit });
+      loops = Array.isArray(out?.loops) ? out.loops : [];
+      turns = Array.isArray(out?.turns) ? out.turns : [];
+      dreamEvents = Array.isArray(out?.dreamEvents) ? out.dreamEvents : [];
+      hasMore = false;
+    } else if (session?.trace && typeof session.trace.fetchRecentDebugHistory === 'function') {
       const out = await session.trace.fetchRecentDebugHistory({ limit, dreamLimit, sessionId, threadId, indexOnly, detailTurnId, search });
       loops = Array.isArray(out?.loops) ? out.loops : [];
       turns = Array.isArray(out?.turns) ? out.turns : [];

package/yeaft/work-center/bridge.js

@@ -121,6 +121,7 @@ async function createDefaultService() {
     policyProvider: async () => readWorkCenterSettings(yeaftDir),
     attachmentRoot: join(yeaftDir, 'work-center', 'attachments'),
     yeaftDir,
+    debug: ctx.CONFIG?.debug === true,
     actionWorktreeRoot: join(yeaftDir, 'work-center', 'worktrees'),
     registry: defaultRegistry,
     store: null,

package/yeaft/work-center/runner.js

@@ -797,7 +797,7 @@ export class WorkItemRunner {
     this.policyProvider = typeof options.policyProvider === 'function' ? options.policyProvider : null;
     this.attachmentRoot = options.attachmentRoot || null;
     this.trace = options.trace || createTrace({
-      enabled: Boolean(options.yeaftDir),
+      enabled: options.debug === true && Boolean(options.yeaftDir),
       dirPath: options.yeaftDir || null,
     });
     this.actionWorktreeRoot = options.actionWorktreeRoot || null;