@econ-v1/app-sdk 7.5.24 → 7.5.25

package/dist/platform/bun.d.ts

@@ -27,7 +27,19 @@ export declare function assertHostEndpoint(): void;
  */
 export declare function connectToHost(handlers: HostConnectionHandlers): HostConnection;
 export declare function createInvocationContextStore<T>(): InvocationContextStore<T>;
-/** @internal Exact isolate sample used by the IPC timer and unit tests. */
+/**
+ * @internal Isolate memory sample used by the IPC timer and unit tests.
+ *
+ * Reads counters only. On Bun >= 1.4.0 (the platform floor),
+ * `process.memoryUsage()` reports the heap size JSC measured at the end of the
+ * last collection, the bytes in allocated heap blocks and the extra/external
+ * memory, so one sample costs about a microsecond whatever the heap size.
+ * `bun:jsc.heapStats()` iterated every live cell (`objectTypeCounts`) instead:
+ * 210 ms for 9 M objects on an M-series Mac, 160-190 ms for the agent app's
+ * 34 MB heap on a Pi Zero 2 W, and on a swapping Pi it paged every idle app's
+ * whole heap back in on every tick (ADR-106). Heap capacity has no counter,
+ * so `heap_capacity_kb` is not reported; the host shows it as not sampled.
+ */
 export declare function _sampleMemory(): AppMemorySample;
 export declare function _captureHeapSnapshotTo(path: string, generate?: () => ArrayBuffer, write?: (path: string, bytes: ArrayBuffer) => Promise<number>): Promise<{
     size_bytes: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/app-sdk",
-  "version": "7.5.24",
+  "version": "7.5.25",
   "description": "TypeScript SDK for building Node mini-app plugins (Bun runtime) on the Lightning-powered marketplace daemon",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",