@amalgm/shell 0.1.164-main.39180777929 → 0.1.164-main.39182422024

package/dist/user-ground-host.d.ts

@@ -125,6 +125,13 @@ export interface UserGroundHostOptions {
      * the type's own lane reports an unselected product and no other type is
      * affected. */
     readonly constructProduct?: EntityApplyHostOptions["constructProduct"];
+    /** How much Files work this runtime still holds: records the cloud has not
+     * accepted, and disk changes not yet recorded. Each reaches zero only when
+     * nothing of its kind could be lost if the disk were destroyed now. */
+    readonly activity?: {
+        readonly unsent: (count: number) => void;
+        readonly unsettled: (count: number) => void;
+    };
     /** A failed background pass (a Send or Receive attempt, an Apply lane, a
      * resumed Add intent, or granted-channel following) remains durable and
      * retries after this report; it never blocks readiness. */
@@ -284,6 +291,10 @@ export declare class UserGroundHost {
     databasePath(): string;
     rows(identity: UserGroundIdentity): GroundRow[];
     watchHealth(): WatchHealth;
+    /** Resolves once what the OS has handed Watch has reached it, already
+     * counted in `activity.unsettled`. On Linux that is every change made
+     * before the call. */
+    flushWatch(): Promise<void>;
     /** Read-only reasons owned by the running Apply coordinator. */
     applyWaiting(): ReturnType<EntityApplyRail["waiting"]>;
     private wakeObservedApply;

package/dist/user-ground-host.js

@@ -341,6 +341,7 @@ export class UserGroundHost {
                         } : {}),
                     },
                 }) } : {}),
+            ...(options.activity ? { onUnsettled: options.activity.unsettled } : {}),
             onHealth: (health) => {
                 options.onWatchHealth?.(health);
                 this.stage({
@@ -515,6 +516,12 @@ export class UserGroundHost {
     watchHealth() {
         return this.watchHost.health();
     }
+    /** Resolves once what the OS has handed Watch has reached it, already
+     * counted in `activity.unsettled`. On Linux that is every change made
+     * before the call. */
+    flushWatch() {
+        return this.watchHost.flush();
+    }
     /** Read-only reasons owned by the running Apply coordinator. */
     applyWaiting() {
         return this.applyRail?.waiting() ?? [];