@yeaft/webchat-agent 1.0.456 → 1.0.457

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.456",
+  "version": "1.0.457",
   "description": "Remote worker agent for Yeaft Web Code Agent — connects the native Yeaft engine, CLI providers, and workbench tools",
   "main": "index.js",
   "type": "module",

package/yeaft/config.js

@@ -377,6 +377,7 @@ function loadLegacyConfig(dir, overrides) {
     // task-318: legacy path never had the `yeaft` section — defaults.
     yeaft: normaliseYeaftSection(null),
     telemetry: normaliseTelemetrySection(null),
+    dream: { enabled: true },
     browserRuntime: normaliseBrowserRuntimeSection(null),
     plugins: {},
     providers: null,
@@ -534,6 +535,7 @@ export function loadConfig(overrides = {}) {
     // don't pollute the flat config namespace used by chat code.
     yeaft: normaliseYeaftSection(jsonConfig.yeaft),
     telemetry: normaliseTelemetrySection(jsonConfig.telemetry),
+    dream: { enabled: jsonConfig.dream?.enabled !== false },
     browserRuntime: normaliseBrowserRuntimeSection(jsonConfig.browserRuntime),
 
     // Agent-level tools / skills / MCP server allowlists. Missing fields mean

package/yeaft/dream/session-wiring.js

@@ -668,8 +668,8 @@ export function createV2DreamScheduler(session) {
     keepAlive: !!session?.config?.serverMode,
     logger: session.config?.debug ? console : undefined,
   });
-  // Auto-start the timer.
-  v2.start();
+  let enabled = session?.config?.dream?.enabled !== false;
+  if (enabled) v2.start();
 
   // task-710: wire `noteUserMessage` to a real per-session message
   // counter. When the count crosses DREAM_NUDGE_AFTER_MESSAGES (default
@@ -685,6 +685,7 @@ export function createV2DreamScheduler(session) {
   // immediately, defeating the 50-message guarantee.
   let messagesSinceLastNudgeFire = 0;
   function nudgeOnUserMessage() {
+    if (!enabled) return;
     messagesSinceLastNudgeFire += 1;
     if (messagesSinceLastNudgeFire < DREAM_NUDGE_AFTER_MESSAGES) return;
     if (v2.isRunning()) {
@@ -709,8 +710,20 @@ export function createV2DreamScheduler(session) {
      * below threshold are skipped — same shape as the interval timer
      * tick. Used by `bootCatchUpStaleDream`.
      */
-    catchUpNudge() { return v2.nudge(); },
+    catchUpNudge() {
+      return enabled ? v2.nudge() : Promise.resolve({ skipped: true, skippedReason: 'disabled', trigger: 'auto' });
+    },
+    setEnabled(nextEnabled) {
+      enabled = nextEnabled !== false;
+      if (enabled) v2.start();
+      else {
+        messagesSinceLastNudgeFire = 0;
+        v2.stop();
+      }
+      return enabled;
+    },
     shutdown() { v2.stop(); },
+    get enabled() { return enabled; },
     get isRunning() { return v2.isRunning(); },
     // Preserve direct access for tests.
     _v2: v2,
@@ -727,12 +740,16 @@ export function createV2DreamScheduler(session) {
  * Pure side-effect, fire-and-forget. Failure logs at debug only — never
  * blocks session load.
  *
- * @param {{ yeaftDir: string, memoryIndex: import('../memory/index-db.js').SegmentIndex|null, dreamScheduler: { triggerDreamForScopes: (s:string[]) => Promise<any> }, config?: { debug?: boolean } }} args
+ * @param {{ yeaftDir: string, memoryIndex: import('../memory/index-db.js').SegmentIndex|null, dreamScheduler: { triggerDreamForScopes: (s:string[]) => Promise<any> }, config?: { debug?: boolean, dream?: { enabled?: boolean } } }} args
  * @returns {Promise<{ triggered: string[] }>}
  */
 export async function bootInitEmptyGroups(args) {
   const out = { triggered: [] };
   if (!args || !args.memoryIndex || !args.dreamScheduler) return out;
+  // This is automatic boot catch-up, not an explicit user trigger. The
+  // scheduler's scoped trigger intentionally remains manual-capable while
+  // disabled, so enforce the Agent toggle at this automatic entry point.
+  if (args.config?.dream?.enabled === false) return out;
   const sessionsRoot = join(args.yeaftDir, 'sessions');
   let ids;
   try { ids = listSessionMetas(sessionsRoot).map(g => g.id); }

package/yeaft/session.js

@@ -136,6 +136,7 @@ export async function loadSession(options = {}) {
     extraTools = [],
     configOverrides = {},
     serverMode = false,
+    dreamEnabled,
     managedCliReady = null,
   } = options;
 
@@ -172,6 +173,7 @@ export async function loadSession(options = {}) {
   // can decide whether to keep its interval timer alive (server) or
   // unref it (CLI / tests). Non-persisted — set per-session by caller.
   if (serverMode) config.serverMode = true;
+  if (typeof dreamEnabled === 'boolean') config.dream.enabled = dreamEnabled;
 
   // Propagate the (clamped) cold-start replay window to the conversation
   // store. The default is 20 turns; a user wanting more recall after a