@stigmer/runner 3.0.8 → 3.0.9-dev.20260615150714

package/src/activities/execute-cursor/persist-decision.ts

@@ -0,0 +1,54 @@
+/**
+ * Streaming persist decision for the Cursor harness.
+ *
+ * Mirrors the native deep-agent harness (execute-deep-agent/streaming.ts):
+ * `shouldPersist = forceFlush || scheduler.shouldSendUpdate(eventCount)`.
+ * Both harnesses thus share one cadence model — discrete state changes flush
+ * immediately, high-frequency token deltas ride a bounded time cadence.
+ *
+ * Extracted as a single pure function so the stream loop and its unit tests
+ * exercise the same implementation and cannot drift.
+ */
+
+import type { StreamingUpdateScheduler } from "../../shared/streaming-scheduler.js";
+
+/**
+ * Force-flush signals — discrete, user-visible state changes that must reach the
+ * live stream immediately, independent of the scheduler's time cadence.
+ */
+export interface ForceFlushSignals {
+  /** Shell/tool output text accumulated past the delta-enricher debounce. */
+  readonly deltaEnricherDirty: boolean;
+  /** The agent's todo list changed. */
+  readonly todosDirty: boolean;
+  /**
+   * A tool call started or reached a terminal status, or a sub-agent was
+   * delegated/updated (MessageAccumulator.isDirty).
+   */
+  readonly contentDirty: boolean;
+}
+
+/**
+ * Decide whether to persist the streaming status after a stream event.
+ *
+ * - forceFlush: any discrete signal flushes now so the live trace (tool calls,
+ *   sub-agents, todos, shell output) is never starved on short turns.
+ * - scheduler: the shared StreamingUpdateScheduler carries assistant text and
+ *   model thinking on a bounded time cadence (500ms floor / 5s keepalive),
+ *   avoiding a per-token persist storm.
+ *
+ * After a persist, the caller must call scheduler.markUpdateSent(eventCount) so
+ * the cadence resets — matching the native harness.
+ *
+ * @param nowMs Injectable clock forwarded to the scheduler, for tests.
+ */
+export function shouldPersistStreamingStatus(
+  signals: ForceFlushSignals,
+  scheduler: StreamingUpdateScheduler,
+  eventCount: number,
+  nowMs?: number,
+): boolean {
+  const forceFlush =
+    signals.deltaEnricherDirty || signals.todosDirty || signals.contentDirty;
+  return forceFlush || scheduler.shouldSendUpdate(eventCount, nowMs);
+}

package/src/activities/execute-deep-agent/index.ts

@@ -23,7 +23,7 @@ import type { Config } from "../../config.js";
 import { StigmerClient } from "../../client/stigmer-client.js";
 import { performSetup, type SetupResult } from "./setup.js";
 import { streamExecution, type StreamResult } from "./streaming.js";
-import { loadStreamingConfig } from "./streaming-scheduler.js";
+import { loadStreamingConfig } from "../../shared/streaming-scheduler.js";
 import { StatusBuilder } from "./status-builder.js";
 import { InlinePublisher } from "./inline-publisher.js";
 import { WriteBackCoordinator } from "./writeback-coordinator.js";

package/src/activities/execute-deep-agent/streaming-v3.ts

@@ -16,7 +16,7 @@ import { ExecutionControlSignal, ExecutionPhase } from "@stigmer/protos/ai/stigm
 import { createV3EventRecorder, type V3ProtocolEvent } from "./v3-event-recorder.js";
 import { normalize } from "./v3-protocol-normalizer.js";
 import { V3StatusBuilder } from "./v3-status-builder.js";
-import { StreamingUpdateScheduler } from "./streaming-scheduler.js";
+import { StreamingUpdateScheduler } from "../../shared/streaming-scheduler.js";
 import { persistStatus, slimStatus } from "../../shared/status.js";
 import { StreamingSideEffects } from "./streaming-side-effects.js";
 import {

package/src/activities/execute-deep-agent/streaming.ts

@@ -32,7 +32,7 @@ import {
 import {
   StreamingUpdateScheduler,
   type StreamingConfig,
-} from "./streaming-scheduler.js";
+} from "../../shared/streaming-scheduler.js";
 import { type RetryOptions } from "../../shared/grpc-retry.js";
 import { persistStatus, slimStatus, utcTimestamp } from "../../shared/status.js";
 import type { ToolOutputOffloadContext } from "../../shared/status-offload.js";

package/src/{activities/execute-deep-agent → shared}/streaming-scheduler.ts

@@ -13,6 +13,10 @@
  *     OR firstUpdate
  *
  * Ported from Python StreamingUpdateScheduler.
+ *
+ * Shared infrastructure: both the native deep-agent harness and the Cursor
+ * harness drive their incremental status persistence through this scheduler so
+ * the live stream cadence is identical across harnesses.
  */
 
 export enum UpdateReason {

package/dist/activities/execute-deep-agent/streaming-scheduler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"streaming-scheduler.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/streaming-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,iDAAiC,CAAA;IACjC,qDAAqC,CAAA;IACrC,uCAAuB,CAAA;IACvB,6CAA6B,CAAA;IAC7B,6BAAa,CAAA;AACf,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAWD,MAAM,cAAc,GAAoB;IACtC,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,aAAa,GAAG,gBAAgB,CACpC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACrC,cAAc,CAAC,aAAa,EAC5B,2BAA2B,CAC5B,CAAC;IACF,IAAI,aAAa,GAAG,gBAAgB,CAClC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACrC,cAAc,CAAC,aAAa,EAC5B,2BAA2B,CAC5B,CAAC;IACF,MAAM,cAAc,GAAG,gBAAgB,CACrC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACrC,cAAc,CAAC,cAAc,EAC7B,2BAA2B,CAC5B,CAAC;IAEF,IAAI,aAAa,GAAG,aAAa,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CACV,8BAA8B,aAAa,MAAM;YACjD,8BAA8B,aAAa,8BAA8B,CAC1E,CAAC;QACF,aAAa,GAAG,aAAa,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,gBAAgB,CACvB,GAAuB,EACvB,QAAgB,EAChB,OAAe;IAEf,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACzE,OAAO,CAAC,IAAI,CACV,WAAW,OAAO,KAAK,GAAG,qBAAqB,QAAQ,EAAE,CAC1D,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,wBAAwB;IAC1B,MAAM,CAAkB;IAEzB,cAAc,CAAS;IACvB,gBAAgB,GAAG,CAAC,CAAC;IACrB,UAAU,GAAiB,YAAY,CAAC,IAAI,CAAC;IAC7C,UAAU,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,YAAY,MAAwB,EAAE,KAAc;QAClD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,cAAc,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,eAAuB,EAAE,KAAc;QACtD,MAAM,GAAG,GAAG,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;QAClD,MAAM,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAEhE,IAAI,IAAI,CAAC,UAAU,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,cAAc,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAClD,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,gBAAgB,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,SAAS,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qDAAqD;IACrD,cAAc,CAAC,eAAuB,EAAE,KAAc;QACpD,IAAI,CAAC,cAAc,GAAG,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;QACjD,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,qBAAqB,CAAC,KAAc;QAClC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC;IAC5D,CAAC;IAED,qBAAqB,CAAC,eAAuB;QAC3C,OAAO,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACjD,CAAC;CACF"}