@tapflowio/agent-core 0.5.0 → 0.6.0

package/dist/utils/index.d.ts

@@ -5,6 +5,8 @@ export { TFFE_MAGIC, HEADER_SIZE, CODEC_JPEG, CODEC_H264, hasEnvelope, writeEnve
 export type { EnvelopeFlags } from './envelope.js';
 export { createThroughputSampler } from './throughput.js';
 export type { ThroughputSample } from './throughput.js';
+export { createSleepBlocker } from './power.js';
+export type { SleepBlocker } from './power.js';
 export { parseSpsVui, rewriteSpsLowLatency, rewriteLowLatencySpsInFrame, } from './sps.js';
 export type { SpsVuiInfo } from './sps.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA"}

package/dist/utils/index.js

@@ -2,5 +2,6 @@ export { createResourceSampler } from './resources.js';
 export { registerStreamWs, sendBinaryWithBackpressure, createKeyframeAwareSender, createRateLimitedDropWarn, DEFAULT_BACKPRESSURE_BYTES, } from './stream.js';
 export { TFFE_MAGIC, HEADER_SIZE, CODEC_JPEG, CODEC_H264, hasEnvelope, writeEnvelopeHeader, readEnvelopeFlags, patchRelayedAt, } from './envelope.js';
 export { createThroughputSampler } from './throughput.js';
+export { createSleepBlocker } from './power.js';
 export { parseSpsVui, rewriteSpsLowLatency, rewriteLowLatencySpsInFrame, } from './sps.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,UAAU,CAAA"}

package/dist/utils/power.d.ts

@@ -0,0 +1,19 @@
+import { spawn } from 'child_process';
+export interface SleepBlocker {
+    /** Start holding the power assertion (idempotent). No-op off macOS. */
+    acquire(): void;
+    /** Release the assertion. Safe to call when not held. */
+    release(): void;
+}
+/**
+ * macOS-only host power assertion via `caffeinate -i`, so the system doesn't
+ * idle-throttle (or sleep) the simulator/emulator while a session is active —
+ * the emulator's software H.264 encoder starves badly when the host idles
+ * (unattended/backgrounded Mac). Off macOS this is a complete no-op.
+ *
+ * `caffeinate -i` only prevents idle/system sleep; it does NOT override battery
+ * CPU scaling. Partial but meaningful mitigation. `platform`/`spawnFn` are
+ * injectable for tests.
+ */
+export declare function createSleepBlocker(platform?: NodeJS.Platform, spawnFn?: typeof spawn): SleepBlocker;
+//# sourceMappingURL=power.d.ts.map

package/dist/utils/power.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power.d.ts","sourceRoot":"","sources":["../../src/utils/power.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAGrC,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAA;IACf,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,OAAO,KAAa,GAC5B,YAAY,CAyBd"}

package/dist/utils/power.js

@@ -0,0 +1,41 @@
+import { spawn } from 'child_process';
+/**
+ * macOS-only host power assertion via `caffeinate -i`, so the system doesn't
+ * idle-throttle (or sleep) the simulator/emulator while a session is active —
+ * the emulator's software H.264 encoder starves badly when the host idles
+ * (unattended/backgrounded Mac). Off macOS this is a complete no-op.
+ *
+ * `caffeinate -i` only prevents idle/system sleep; it does NOT override battery
+ * CPU scaling. Partial but meaningful mitigation. `platform`/`spawnFn` are
+ * injectable for tests.
+ */
+export function createSleepBlocker(platform = process.platform, spawnFn = spawn) {
+    let proc = null;
+    return {
+        acquire() {
+            if (proc || platform !== 'darwin')
+                return;
+            try {
+                const child = spawnFn('caffeinate', ['-i'], { stdio: 'ignore' });
+                proc = child;
+                // Drop the handle on any termination (missing binary, external kill, exit) so a
+                // later acquire() re-spawns. Guard on identity so a stale child's late event can't
+                // null out a newer one.
+                const clear = () => { if (proc === child)
+                    proc = null; };
+                child.once('error', clear);
+                child.once('close', clear);
+                child.once('exit', clear);
+                child.unref();
+            }
+            catch {
+                proc = null;
+            }
+        },
+        release() {
+            proc?.kill();
+            proc = null;
+        },
+    };
+}
+//# sourceMappingURL=power.js.map

package/dist/utils/power.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"power.js","sourceRoot":"","sources":["../../src/utils/power.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAUrC;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,UAAwB,KAAK;IAE7B,IAAI,IAAI,GAAwB,IAAI,CAAA;IACpC,OAAO;QACL,OAAO;YACL,IAAI,IAAI,IAAI,QAAQ,KAAK,QAAQ;gBAAE,OAAM;YACzC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;gBAChE,IAAI,GAAG,KAAK,CAAA;gBACZ,gFAAgF;gBAChF,mFAAmF;gBACnF,wBAAwB;gBACxB,MAAM,KAAK,GAAG,GAAS,EAAE,GAAG,IAAI,IAAI,KAAK,KAAK;oBAAE,IAAI,GAAG,IAAI,CAAA,CAAC,CAAC,CAAA;gBAC7D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;gBAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;gBAC1B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;gBACzB,KAAK,CAAC,KAAK,EAAE,CAAA;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,EAAE,CAAA;YACZ,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tapflowio/agent-core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "DeviceAgent interface, AgentRegistry, and shared utilities for tapflow agents",
   "keywords": [
     "tapflow",