botmux 3.11.0 → 3.12.1

package/dist/utils/runtime-screen-status.js

@@ -0,0 +1,60 @@
+/**
+ * Project worker runtime facts into the status consumed by Lark cards and the
+ * Dashboard. A structured transcript lifecycle outranks screen readiness:
+ * prompt glyphs and PTY quiescence are UI hints, while a transcript-started
+ * turn without assistant_final is explicit evidence that work is still running;
+ * a verified submit also blocks during its bounded transcript-start hand-off.
+ */
+export function projectRuntimeScreenStatus(state) {
+    if (state.analyzing)
+        return 'analyzing';
+    if (state.structuredTurnBlocking)
+        return 'working';
+    return state.promptReady ? 'idle' : 'working';
+}
+/** Await an asynchronous screen snapshot before reading runtime status. A
+ *  periodic tick can spend measurable time in tmux/observe capture; projecting
+ *  first lets a turn that starts during that await receive a late, stale idle
+ *  update. Keeping the ordering in one helper makes the race deterministic in
+ *  tests and forces callers to read lifecycle state at send time. */
+export async function snapshotWithLatestRuntimeStatus(capture, projectStatus) {
+    const snapshot = await capture();
+    return { snapshot, status: projectStatus() };
+}
+/** Monotonic evidence for PTY chunks fed to readiness detection. Wall-clock
+ *  milliseconds are not unique: two redraw chunks can land in the same ms,
+ *  making timestamp equality falsely claim that no output followed a rejected
+ *  ready signal. A generation changes for every observed chunk instead. */
+export class PtyOutputGeneration {
+    generation = 0;
+    observe() {
+        this.generation++;
+        return this.generation;
+    }
+    snapshot() {
+        return this.generation;
+    }
+    isCurrent(snapshot) {
+        return this.generation === snapshot;
+    }
+    reset() {
+        this.generation = 0;
+    }
+}
+/** Validate a callback captured for one CLI/backend generation. A restart can
+ * invalidate the generation before async teardown swaps out the backend
+ * object, so backend identity alone is not a sufficient fence. */
+export function isCliBackendGenerationCurrent(fence, current) {
+    return fence.generation === current.generation
+        && fence.backend === current.backend
+        && !current.restartInProgress;
+}
+/** Enter a fresh CLI-write cycle synchronously, before the adapter is allowed
+ *  to yield. This ordering matters for fast turns: transcript final can arrive
+ *  while writeInput is still polling submit history, and IdleDetector must be
+ *  re-armed before that final edge rather than reset after it. */
+export function beginRuntimeWriteCycle(hooks) {
+    hooks.setPromptReady(false);
+    hooks.resetIdleDetector();
+}
+//# sourceMappingURL=runtime-screen-status.js.map

package/dist/utils/runtime-screen-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-screen-status.js","sourceRoot":"","sources":["../../src/utils/runtime-screen-status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAI1C;IACC,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IACxC,IAAI,KAAK,CAAC,sBAAsB;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;;;qEAIqE;AACrE,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAAyB,EACzB,aAAkE;IAElE,MAAM,QAAQ,GAAG,MAAM,OAAO,EAAE,CAAC;IACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;;2EAG2E;AAC3E,MAAM,OAAO,mBAAmB;IACtB,UAAU,GAAG,CAAC,CAAC;IAEvB,OAAO;QACL,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC;IACtC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED;;kEAEkE;AAClE,MAAM,UAAU,6BAA6B,CAC3C,KAAyC,EACzC,OAAuE;IAEvE,OAAO,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;WACzC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;WACjC,CAAC,OAAO,CAAC,iBAAiB,CAAC;AAClC,CAAC;AAED;;;kEAGkE;AAClE,MAAM,UAAU,sBAAsB,CAAC,KAGtC;IACC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5B,KAAK,CAAC,iBAAiB,EAAE,CAAC;AAC5B,CAAC"}