@adhdev/daemon-core 0.9.82-rc.215 → 0.9.82-rc.217

package/dist/providers/spec/driver.d.ts

@@ -156,6 +156,9 @@ export declare class SpecDriver {
      *  Used by screen_active_hold_ms to suppress idle downshifts while
      *  the terminal is still actively updating. */
     private lastScreenChangedAt;
+    /** Per-cursor_above region last-changed timestamps for stable_ms tracking.
+     *  Key: cursor_above value. Value: last time that region changed. */
+    private regionLastChangedAt;
     /** Timer that re-runs evaluate() once the hold window expires. Needed
      *  because the PTY stops emitting once the agent finishes; without an
      *  explicit wake-up there's nothing to trigger the busy → idle

package/dist/providers/spec/schema.gen.d.ts

@@ -908,7 +908,10 @@ export declare const SCHEMA_V3: {
                 };
                 readonly changed: {
                     readonly type: "boolean";
-                    readonly const: true;
+                };
+                readonly stable_ms: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
                 };
             };
         };
@@ -1608,7 +1611,10 @@ export declare const SCHEMA: {
                 };
                 readonly changed: {
                     readonly type: "boolean";
-                    readonly const: true;
+                };
+                readonly stable_ms: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
                 };
             };
         };

package/dist/providers/spec/types.d.ts

@@ -155,10 +155,13 @@ export interface RegexCondition {
     cursor_col_min?: number;
     cursor_col_max?: number;
 }
-/** v3 delta condition: N lines above cursor changed vs prevLines. */
+/** v3 delta condition: N lines above cursor changed vs prevLines.
+ *  changed:false + stable_ms: region must be stable for at least N ms. */
 export interface ChangedCondition {
     cursor_above: number;
-    changed: true;
+    changed: boolean;
+    /** Only for changed:false — region must have been stable for this many ms. */
+    stable_ms?: number;
 }
 /** v3 AND composite. */
 export interface AllCondition {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.9.82-rc.215",
+  "version": "0.9.82-rc.217",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/providers/spec/driver.ts

@@ -41,7 +41,7 @@ import type { PtyTransportFactory } from '../../cli-adapters/pty-transport.js';
 import { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS } from '@adhdev/session-host-core';
 import { evaluate, type SpecEvaluation, type TraceEntry } from './evaluator.js';
 import { loadSpec } from './loader.js';
-import type { CliSpec, Control, DelegateTrigger, SectionDef } from './types.js';
+import type { CliSpec, Condition, ChangedCondition, Control, DelegateTrigger, SectionDef } from './types.js';
 import { LOG } from '../../logging/logger.js';
 
 export type DashboardEvent =
@@ -112,6 +112,14 @@ const BUSY_HOLD_MS = 6000;
  *  codex's explicit setting and is barely perceptible to a human caller. */
 const SUBMIT_DELAY_FLOOR_MS = 200;
 
+function collectChangedConditions(when: Condition | undefined): ChangedCondition[] {
+    if (!when) return [];
+    if ('cursor_above' in when && 'changed' in when) return [when as ChangedCondition];
+    if ('all' in when) return when.all.flatMap(c => collectChangedConditions(c));
+    if ('any' in when) return when.any.flatMap(c => collectChangedConditions(c));
+    return [];
+}
+
 function countNewlines(s: string): number {
     let n = 0;
     for (let i = 0; i < s.length; i += 1) if (s.charCodeAt(i) === 10) n += 1;
@@ -240,6 +248,9 @@ export class SpecDriver {
      *  Used by screen_active_hold_ms to suppress idle downshifts while
      *  the terminal is still actively updating. */
     private lastScreenChangedAt = 0;
+    /** Per-cursor_above region last-changed timestamps for stable_ms tracking.
+     *  Key: cursor_above value. Value: last time that region changed. */
+    private regionLastChangedAt = new Map<number, number>();
     /** Timer that re-runs evaluate() once the hold window expires. Needed
      *  because the PTY stops emitting once the agent finishes; without an
      *  explicit wake-up there's nothing to trigger the busy → idle
@@ -482,9 +493,24 @@ export class SpecDriver {
         const cursor = this.adapter.getCursorPosition();
         const currentLines = screen.split('\n').map(l => l.endsWith('\r') ? l.slice(0, -1) : l);
         const ev = evaluate(this.spec, screen, cursor, this.prevScreenLines.length > 0 ? this.prevScreenLines : undefined);
+        const now = Date.now();
         // Track when the screen last changed for screen_active_hold_ms.
         if (this.prevScreenLines.length > 0 && currentLines.join('\n') !== this.prevScreenLines.join('\n')) {
-            this.lastScreenChangedAt = Date.now();
+            this.lastScreenChangedAt = now;
+        }
+        // Track per-region last-changed timestamps for stable_ms conditions.
+        if (cursor && this.prevScreenLines.length > 0) {
+            for (const state of this.spec.states) {
+                const conditions = collectChangedConditions(state.when);
+                for (const cond of conditions) {
+                    if (cond.stable_ms == null) continue;
+                    const startRow = Math.max(0, cursor.row - cond.cursor_above);
+                    const endRow = cursor.row;
+                    const cur = currentLines.slice(startRow, endRow).join('\n');
+                    const prev = this.prevScreenLines.slice(startRow, endRow).join('\n');
+                    if (cur !== prev) this.regionLastChangedAt.set(cond.cursor_above, now);
+                }
+            }
         }
         // Update prevScreenLines for next evaluation's `changed` condition detection.
         this.prevScreenLines = currentLines;
@@ -500,7 +526,7 @@ export class SpecDriver {
         let evState = ev.state;
         const busyHoldMs = this.spec.debounce?.busy_hold_ms ?? BUSY_HOLD_MS;
         if (this.currentStateId === 'busy' && evState.id === 'idle') {
-            const ageMs = Date.now() - this.lastBusyAt;
+            const ageMs = now - this.lastBusyAt;
             if (ageMs < busyHoldMs) {
                 // Pin to the last seen busy state directly — currentEval can
                 // already be idle at this point (it tracks the previous tick,
@@ -509,6 +535,24 @@ export class SpecDriver {
                 evState = this.lastBusyState ?? evState;
             }
         }
+        // stable_ms gate: if the matched idle state has a changed:false/stable_ms
+        // condition, verify the region has been stable long enough. If not, pin
+        // to busy and schedule a re-evaluation when the stable window expires.
+        if (evState.id === (this.spec.default_state ?? 'idle') && cursor) {
+            const stableConditions = collectChangedConditions(
+                this.spec.states.find(s => s.id === evState.id)?.when
+            ).filter(c => c.changed === false && c.stable_ms != null);
+            for (const cond of stableConditions) {
+                const lastChanged = this.regionLastChangedAt.get(cond.cursor_above) ?? 0;
+                const stableMs = cond.stable_ms!;
+                const stableAge = lastChanged > 0 ? now - lastChanged : Infinity;
+                if (stableAge < stableMs) {
+                    evState = this.lastBusyState ?? { id: 'busy', label: 'Generating', title: null };
+                    this.scheduleBusyExpiry(stableMs - stableAge + 50);
+                    break;
+                }
+            }
+        }
         // Modal hold: when in a modal state (approval, picker, etc.) a brief
         // busy reading should not interrupt the modal. Claude Code streams
         // body content while the approval modal is visible, causing a spinner
@@ -538,7 +582,6 @@ export class SpecDriver {
         //    approval appeared and its hold expires immediately after dismissal,
         //    causing a false-idle even though the agent is still generating.
         const postModalGraceMs = busyHoldMs;
-        const now = Date.now();
         const recentlyInModal = isModalState(this.currentStateId) || (this.lastModalAt > 0 && now - this.lastModalAt < postModalGraceMs);
         const recentlyLeftModal = !recentlyInModal && this.lastModalExitAt > 0 && now - this.lastModalExitAt < postModalGraceMs;
         // screen_active_hold_ms: suppress idle downshift while the screen is
@@ -555,7 +598,6 @@ export class SpecDriver {
         if (evState.id === 'busy' && completionIdleRule && !recentlyInModal && !recentlyLeftModal && !screenIsActive) {
             const completionKey = matchesCompletionIdleRule(this.spec, ev, screen);
             if (completionKey) {
-                const now = Date.now();
                 if (completionKey !== this.completionIdleKey) {
                     this.completionIdleKey = completionKey;
                     this.completionIdleFirstSeenAt = now;

package/src/providers/spec/evaluator.ts

@@ -227,8 +227,11 @@ function evaluateCondition(
         const endRow = cursor.row; // exclusive
         const currentSlice = curLines.slice(startRow, endRow).join('\n');
         const prevSlice = prevLines.slice(startRow, endRow).join('\n');
-        const result = currentSlice !== prevSlice;
-        trace.push({ kind: 'section', text: `state[${stateId}] changed cond cursor_above=${cond.cursor_above} rows[${startRow},${endRow}) changed=${result}` });
+        const didChange = currentSlice !== prevSlice;
+        // changed:false means "region is currently stable" — stable_ms duration
+        // is enforced by the driver, not here.
+        const result = cond.changed ? didChange : !didChange;
+        trace.push({ kind: 'section', text: `state[${stateId}] changed cond cursor_above=${cond.cursor_above} rows[${startRow},${endRow}) changed=${didChange} expected=${cond.changed} result=${result}` });
         return result;
     }
 

package/src/providers/spec/schema.gen.ts

@@ -460,7 +460,8 @@ export const SCHEMA_V3 = {
             "required": ["cursor_above", "changed"],
             "properties": {
                 "cursor_above": { "type": "integer", "minimum": 1 },
-                "changed": { "type": "boolean", "const": true }
+                "changed": { "type": "boolean" },
+                "stable_ms": { "type": "integer", "minimum": 0 }
             }
         },
         "allCondition": {

package/src/providers/spec/types.ts

@@ -192,10 +192,13 @@ export interface RegexCondition {
     cursor_col_max?: number;
 }
 
-/** v3 delta condition: N lines above cursor changed vs prevLines. */
+/** v3 delta condition: N lines above cursor changed vs prevLines.
+ *  changed:false + stable_ms: region must be stable for at least N ms. */
 export interface ChangedCondition {
     cursor_above: number;
-    changed: true;
+    changed: boolean;
+    /** Only for changed:false — region must have been stable for this many ms. */
+    stable_ms?: number;
 }
 
 /** v3 AND composite. */