omniharness-cli 0.1.37 → 0.1.39

package/dist/ui/termcaps.js

@@ -0,0 +1,76 @@
+/**
+ * Terminal capability primitives — zero-dependency escape sequences that
+ * degrade to nothing on terminals that don't support them.
+ *
+ * Pure helpers plus two small stateful wrappers (`wrapSynchronizedOutput`,
+ * `isSyncOutputReply`). Nothing here assumes a capability: callers probe
+ * first (like the kitty-protocol query in `keys.ts`) and only enable a
+ * feature once the terminal answers.
+ *
+ *   - Synchronized Output (DECSET 2026): bracket each frame so the terminal
+ *     composites the whole update at once instead of tearing mid-repaint.
+ *   - OSC 52: write the system clipboard (works over SSH and tmux). Most
+ *     terminals allow writes and refuse reads, so this is write-only.
+ *   - OSC 9: fire a desktop notification when a long run finishes.
+ *   - BEL: the terminal bell, gated by the caller to "long + unfocused".
+ */
+/** DECSET 2026 — begin a synchronized (tear-free) frame. */
+export const SYNC_BEGIN = '\x1b[?2026h';
+/** DECRST 2026 — end the synchronized frame; terminal flushes it atomically. */
+export const SYNC_END = '\x1b[?2026l';
+/** DECRQM 2026 — ask whether synchronized output is supported. */
+export const SYNC_QUERY = '\x1b[?2026$p';
+/**
+ * True when `chunk` is the terminal's answer to {@link SYNC_QUERY}
+ * (`ESC [ ? 2026 ; <state> $ y`). State 1 = set, 2 = reset, 3/4 = permanently
+ * set/reset — any of them means the mode is recognised, which is all we need.
+ */
+export function isSyncOutputReply(chunk) {
+    return /\x1b\[\?2026;[0-4]\$y/.test(chunk);
+}
+/**
+ * Wrap a writable stream so every string write is bracketed by the
+ * synchronized-output markers. Ink emits one `write()` per rendered frame, so
+ * this makes each frame tear-free without hooking React's commit phase.
+ * Returns a restore function. Non-string chunks (rare from Ink) pass through
+ * untouched so binary writes are never corrupted.
+ */
+export function wrapSynchronizedOutput(stream) {
+    const original = stream.write.bind(stream);
+    stream.write = (chunk, ...rest) => {
+        if (typeof chunk === 'string' && chunk.length > 0) {
+            return original(`${SYNC_BEGIN}${chunk}${SYNC_END}`, ...rest);
+        }
+        return original(chunk, ...rest);
+    };
+    return () => { stream.write = original; };
+}
+/**
+ * OSC 52 clipboard-write sequence for `text`. Base64 is required by the
+ * protocol. Terminals cap the payload (commonly ~74–100 KB before the encode);
+ * we refuse anything that would obviously exceed that rather than emit a
+ * sequence the terminal will silently drop.
+ */
+export function osc52Copy(text) {
+    const encoded = Buffer.from(text, 'utf8').toString('base64');
+    if (encoded.length > 96_000)
+        return null;
+    return `\x1b]52;c;${encoded}\x07`;
+}
+/** OSC 9 desktop-notification sequence (iTerm2, WezTerm, Ghostty, Windows Terminal). */
+export function osc9Notify(title) {
+    // Strip control characters; the sequence is terminated by BEL.
+    return `\x1b]9;${title.replace(/[\x00-\x1f\x7f]/g, ' ').slice(0, 200)}\x07`;
+}
+/** The terminal bell. Caller decides when it's warranted. */
+export const BEL = '\x07';
+/**
+ * Whether a "run finished" nudge (bell + notification) is warranted: the run
+ * took long enough to have caused a context switch, and the terminal isn't
+ * the focused window. Focus is unknowable without extra querying, so callers
+ * pass what they have; default is "assume unfocused after a long run".
+ */
+export function shouldNudgeOnFinish(elapsedMs, focused = false, thresholdMs = 10_000) {
+    return elapsedMs >= thresholdMs && !focused;
+}
+//# sourceMappingURL=termcaps.js.map

package/dist/ui/termcaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"termcaps.js","sourceRoot":"","sources":["../../src/ui/termcaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AACxC,gFAAgF;AAChF,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC;AACtC,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAkE;IACvG,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,GAAG,CAAC,KAAc,EAAE,GAAG,IAAe,EAAW,EAAE;QAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,QAAQ,CAAC,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,QAAQ,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,aAAa,OAAO,MAAM,CAAC;AACpC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,+DAA+D;IAC/D,OAAO,UAAU,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,OAAO,GAAG,KAAK,EAAE,WAAW,GAAG,MAAM;IAC1F,OAAO,SAAS,IAAI,WAAW,IAAI,CAAC,OAAO,CAAC;AAC9C,CAAC"}