@serfab/cadre-core 1.17.0 → 1.18.0

package/dist/strand-watcher.d.ts

@@ -1,4 +1,16 @@
+import type { TableChangeWatch, TableChangeWatchOptions } from './table-change-watch.js';
 import type { StrandFilter, StrandRow } from './types.js';
+/**
+ * Default backstop: the longest the watcher goes without re-reading when no change to
+ * `Strand` or `JoinedStrand` is heard (`docs/architecture.md` → "Table change subscriptions"
+ * says what the change subscription misses).
+ *
+ * NOTE: on a cadre larger than `CONTROL_REPLICATION_BREADTH` (16), a machine outside the
+ * `Strand` block's cohort hears no change event, so this backstop is its only path and a
+ * strand founded elsewhere reaches it up to 5 minutes later. If that matters, shorten the
+ * backstop for such machines rather than for everyone.
+ */
+export declare const DEFAULT_STRAND_WATCH_BACKSTOP_MS: number;
 /**
  * Extended strand row that includes the sAppId for filtering purposes.
  * The sAppId is provided by the hosting application, not from the control network.
@@ -15,10 +27,14 @@ export interface StrandWatcherCallbacks {
     onStrandRemoved: (strandId: string) => Promise<void>;
 }
 /**
- * Interface for querying strands from control network
+ * What the watcher reads, and how it hears that what it reads changed.
  */
 export interface StrandQueryable {
     queryStrands(): Promise<StrandRow[]>;
+    /** Subscribe to changes of the tables {@link queryStrands} reads. Absent: runs come from `trigger` and the backstop only. */
+    watchChanges?(onChange: () => Promise<void>, options: TableChangeWatchOptions): TableChangeWatch;
+    /** True when the last {@link queryStrands} answered part of its result from a stand-in after a failed read. */
+    lastReadPartial?(): boolean;
 }
 /**
  * Interface for looking up sAppId for a strand (for filtering)
@@ -31,11 +47,16 @@ export interface SAppIdLookup {
  * Watches the control network's Strand table for changes and triggers
  * strand instance start/stop via callbacks.
  *
- * Uses polling until Optimystic supports reactive subscriptions.
+ * Every read is one run on a {@link TableChangeWatch}: once at start, on a change to the
+ * tables the queryable reads, on the watcher's own retries, and on the backstop.
  */
 export declare class StrandWatcher {
     private readonly filter;
-    private readonly pollInterval;
+    /** Longest gap between runs when no change is heard. */
+    private readonly backstopMs;
+    /** First step of the launch-retry and read-retry ladders. */
+    private readonly retryBaseMs;
+    private readonly readRetryCapMs;
     private readonly callbacks;
     private readonly queryable;
     private readonly sAppIdLookup?;
@@ -48,7 +69,7 @@ export declare class StrandWatcher {
      */
     private readonly now;
     private knownStrands;
-    /** Ids admitted under a `defer` decision; re-evaluated each poll until they resolve. */
+    /** Ids admitted under a `defer` decision; re-evaluated each run until they resolve. */
     private provisional;
     /** Ids whose last launch attempt threw, with the backoff gating their retry. */
     private failureStates;
@@ -59,36 +80,69 @@ export declare class StrandWatcher {
      * strand, the permanence has to be recorded explicitly.
      */
     private suppressed;
-    private pollTimer;
-    private initialPollTimer;
+    /** Consecutive runs whose read failed or was partial; drives {@link scheduleReadRetry}. */
+    private readFailures;
+    /** Built by {@link start}, disposed by {@link stop}; a restart builds a new one. */
+    private watch;
     private running;
-    constructor(queryable: StrandQueryable, callbacks: StrandWatcherCallbacks, filter?: StrandFilter, pollInterval?: number, sAppIdLookup?: SAppIdLookup, now?: () => number);
+    /**
+     * @param backstopMs - `CadreNodeConfig.strandWatchInterval`: the longest the watcher goes
+     *   without re-reading when no change is heard. Also caps the retry ladders' first step.
+     */
+    constructor(queryable: StrandQueryable, callbacks: StrandWatcherCallbacks, filter?: StrandFilter, backstopMs?: number, sAppIdLookup?: SAppIdLookup, now?: () => number);
     /**
      * Evaluate a strand against the current filter, distinguishing a not-yet-known
      * sAppId (`defer`) from a known non-match (`reject`). A `defer` admission is
-     * provisional and re-checked on subsequent polls.
+     * provisional and re-checked on subsequent runs (see {@link sAppIdLearned}).
      */
     private evaluateFilter;
     /**
      * Record a failed launch attempt and schedule when the strand may be retried:
-     * `pollInterval * 2^(failures-1)`, capped at {@link MAX_RETRY_BACKOFF_MS}.
+     * `retryBaseMs * 2^(failures-1)`, capped at {@link MAX_RETRY_BACKOFF_MS}.
      */
     private recordFailure;
     /**
-     * Poll for strand changes.
+     * One run: read, reconcile, then arm the follow-up runs this run needs. A run the watch
+     * starts clears every pending wake, so each run re-arms the retries still owed. A
+     * {@link forcePoll} run clears none, so what it arms may sit beside an equivalent wake;
+     * whichever fires first runs and clears the other.
+     */
+    private runOnce;
+    /**
+     * Wake for the earliest launch retry falling due after `since`. A backoff that expired at
+     * or before `since` belongs to a strand the run starting then either attempted or skipped
+     * for a reason other than backoff (suppressed, filtered out); waking for it would spin.
+     * Without this a failed launch would wait for an unrelated change or the backstop.
+     */
+    private scheduleLaunchRetry;
+    /**
+     * After a failed or partial read, run again on a ladder from `retryBaseMs`, doubling per
+     * consecutive failed run up to `readRetryCapMs`; a complete read resets it. Not left to
+     * the backstop because the plugin arms a table's replicated-change bridge on the table's
+     * first successful initialization: a machine whose first read failed (cut off from its
+     * party, or its sibling unreachable for a never-written `JoinedStrand`) would otherwise
+     * hear nothing until then.
+     */
+    private scheduleReadRetry;
+    /**
+     * Read and reconcile. Resolves true when the read answered in full: false when it threw,
+     * or when the queryable answered part of it from a stand-in.
      */
     private poll;
     /**
      * Start watching for strand changes
      */
     start(): Promise<void>;
+    /** The watch every run goes through: the queryable's change subscription, or a timer-only one. */
+    private subscribe;
     /**
      * Stop watching for strand changes
      */
     stop(): Promise<void>;
     /**
-     * Forget a strand whose launch failed outside this watcher, so a later poll
-     * re-offers it — gated by the same backoff a watcher-driven failure gets.
+     * Forget a strand whose launch failed outside this watcher, so a later run
+     * re-offers it — gated by the same backoff a watcher-driven failure gets, and woken
+     * when that backoff expires.
      *
      * A failed launch normally leaves nothing running (StrandInstanceManager drops the
      * record), which is what makes re-offering it correct. One case does leave something
@@ -99,6 +153,16 @@ export declare class StrandWatcher {
      * not read the line above as "nothing is running".
      */
     forgetStrand(strandId: string): void;
+    /**
+     * Re-read soon: something the queryable merges in beside the watched tables changed
+     * (`CadreNode`'s machine-local joined-strand records). A no-op once stopped.
+     */
+    refresh(): void;
+    /**
+     * The host just learned `strandId`'s sAppId: if the strand was admitted provisionally
+     * under an `sAppId` filter, run so the admission resolves now rather than on the backstop.
+     */
+    sAppIdLearned(strandId: string): void;
     /**
      * Never offer this strand again this session. Two callers, both meaning "the retry
      * ladder cannot help here": a deliberate local stop, and a launch that can never
@@ -129,7 +193,10 @@ export declare class StrandWatcher {
      */
     getKnownStrands(): Map<string, StrandRow>;
     /**
-     * Force an immediate poll (useful for testing)
+     * Run once now, outside the watch's schedule (tests, and callers that just wrote a row
+     * and want this node to converge before returning). May overlap a scheduled run:
+     * `knownStrands` is updated before each callback's await, so neither launches nor
+     * removes a strand twice.
      */
     forcePoll(): Promise<void>;
 }

package/dist/strand-watcher.js

@@ -1,22 +1,48 @@
 import debug from 'debug';
+import { scheduleRuns } from './table-change-watch.js';
 const log = debug('sereus:cadre:strand-watcher');
 /**
  * Ceiling on the retry delay for a strand whose launch keeps failing. Attempts
  * are never abandoned — the failure this backoff exists for (a transient network
  * or storage fault) can last a long time — but a permanently-unlaunchable strand
- * must not re-attempt on every poll and storm the host app with `strand:error`.
+ * must not re-attempt on every run and storm the host app with `strand:error`.
  */
 const MAX_RETRY_BACKOFF_MS = 5 * 60 * 1000;
+/**
+ * Default backstop: the longest the watcher goes without re-reading when no change to
+ * `Strand` or `JoinedStrand` is heard (`docs/architecture.md` → "Table change subscriptions"
+ * says what the change subscription misses).
+ *
+ * NOTE: on a cadre larger than `CONTROL_REPLICATION_BREADTH` (16), a machine outside the
+ * `Strand` block's cohort hears no change event, so this backstop is its only path and a
+ * strand founded elsewhere reaches it up to 5 minutes later. If that matters, shorten the
+ * backstop for such machines rather than for everyone.
+ */
+export const DEFAULT_STRAND_WATCH_BACKSTOP_MS = 5 * 60 * 1000;
+/**
+ * First step of the launch-retry and read-retry ladders, unless the backstop is shorter: a
+ * test or scenario that passes a short interval keeps the short base it always had.
+ */
+const LAUNCH_RETRY_BASE_MS = 5000;
+/** Ceiling on the read-retry ladder (see `StrandWatcher.scheduleReadRetry`), unless the backstop is shorter. */
+const READ_RETRY_CAP_MS = 60000;
+/** Delay before the first run, so `start()` never reads synchronously. */
+const INITIAL_RUN_DELAY_MS = 100;
 /**
  * Watches the control network's Strand table for changes and triggers
  * strand instance start/stop via callbacks.
  *
- * Uses polling until Optimystic supports reactive subscriptions.
+ * Every read is one run on a {@link TableChangeWatch}: once at start, on a change to the
+ * tables the queryable reads, on the watcher's own retries, and on the backstop.
  */
 export class StrandWatcher {
-    constructor(queryable, callbacks, filter = { mode: 'all' }, pollInterval = 5000, sAppIdLookup, now = Date.now) {
+    /**
+     * @param backstopMs - `CadreNodeConfig.strandWatchInterval`: the longest the watcher goes
+     *   without re-reading when no change is heard. Also caps the retry ladders' first step.
+     */
+    constructor(queryable, callbacks, filter = { mode: 'all' }, backstopMs = DEFAULT_STRAND_WATCH_BACKSTOP_MS, sAppIdLookup, now = Date.now) {
         this.knownStrands = new Map();
-        /** Ids admitted under a `defer` decision; re-evaluated each poll until they resolve. */
+        /** Ids admitted under a `defer` decision; re-evaluated each run until they resolve. */
         this.provisional = new Set();
         /** Ids whose last launch attempt threw, with the backoff gating their retry. */
         this.failureStates = new Map();
@@ -27,21 +53,25 @@ export class StrandWatcher {
          * strand, the permanence has to be recorded explicitly.
          */
         this.suppressed = new Set();
-        this.pollTimer = null;
-        this.initialPollTimer = null;
+        /** Consecutive runs whose read failed or was partial; drives {@link scheduleReadRetry}. */
+        this.readFailures = 0;
+        /** Built by {@link start}, disposed by {@link stop}; a restart builds a new one. */
+        this.watch = null;
         this.running = false;
         this.queryable = queryable;
         this.callbacks = callbacks;
         this.filter = filter;
-        this.pollInterval = pollInterval;
+        this.backstopMs = backstopMs;
+        this.retryBaseMs = Math.min(backstopMs, LAUNCH_RETRY_BASE_MS);
+        this.readRetryCapMs = Math.min(backstopMs, READ_RETRY_CAP_MS);
         this.sAppIdLookup = sAppIdLookup;
         this.now = now;
-        log('StrandWatcher created with filter: %o, interval: %dms', filter, pollInterval);
+        log('StrandWatcher created with filter: %o, backstop: %dms', filter, backstopMs);
     }
     /**
      * Evaluate a strand against the current filter, distinguishing a not-yet-known
      * sAppId (`defer`) from a known non-match (`reject`). A `defer` admission is
-     * provisional and re-checked on subsequent polls.
+     * provisional and re-checked on subsequent runs (see {@link sAppIdLearned}).
      */
     evaluateFilter(strand) {
         switch (this.filter.mode) {
@@ -58,7 +88,7 @@ export class StrandWatcher {
                 }
                 const sAppId = this.sAppIdLookup.getSAppId(strand.Id);
                 if (sAppId === undefined) {
-                    // sAppId not yet known - admit provisionally and re-evaluate next poll.
+                    // sAppId not yet known - admit provisionally and re-evaluate once it is learned.
                     log('sAppId unknown for strand %s - deferring filter decision', strand.Id);
                     return 'defer';
                 }
@@ -72,20 +102,70 @@ export class StrandWatcher {
     }
     /**
      * Record a failed launch attempt and schedule when the strand may be retried:
-     * `pollInterval * 2^(failures-1)`, capped at {@link MAX_RETRY_BACKOFF_MS}.
+     * `retryBaseMs * 2^(failures-1)`, capped at {@link MAX_RETRY_BACKOFF_MS}.
      */
     recordFailure(strandId) {
         const failures = (this.failureStates.get(strandId)?.failures ?? 0) + 1;
-        const delay = Math.min(this.pollInterval * 2 ** (failures - 1), MAX_RETRY_BACKOFF_MS);
+        const delay = Math.min(this.retryBaseMs * 2 ** (failures - 1), MAX_RETRY_BACKOFF_MS);
         this.failureStates.set(strandId, { failures, nextAttemptAt: this.now() + delay });
         log('Strand %s launch failed (%d consecutive) - next attempt in %dms', strandId, failures, delay);
     }
     /**
-     * Poll for strand changes.
+     * One run: read, reconcile, then arm the follow-up runs this run needs. A run the watch
+     * starts clears every pending wake, so each run re-arms the retries still owed. A
+     * {@link forcePoll} run clears none, so what it arms may sit beside an equivalent wake;
+     * whichever fires first runs and clears the other.
+     */
+    async runOnce() {
+        const startedAt = this.now();
+        const readComplete = await this.poll();
+        if (this.running) {
+            this.scheduleLaunchRetry(startedAt);
+            this.scheduleReadRetry(readComplete);
+        }
+    }
+    /**
+     * Wake for the earliest launch retry falling due after `since`. A backoff that expired at
+     * or before `since` belongs to a strand the run starting then either attempted or skipped
+     * for a reason other than backoff (suppressed, filtered out); waking for it would spin.
+     * Without this a failed launch would wait for an unrelated change or the backstop.
+     */
+    scheduleLaunchRetry(since) {
+        let earliest = Infinity;
+        for (const { nextAttemptAt } of this.failureStates.values()) {
+            if (nextAttemptAt > since) {
+                earliest = Math.min(earliest, nextAttemptAt);
+            }
+        }
+        if (earliest !== Infinity) {
+            this.watch?.trigger(Math.max(0, earliest - this.now()));
+        }
+    }
+    /**
+     * After a failed or partial read, run again on a ladder from `retryBaseMs`, doubling per
+     * consecutive failed run up to `readRetryCapMs`; a complete read resets it. Not left to
+     * the backstop because the plugin arms a table's replicated-change bridge on the table's
+     * first successful initialization: a machine whose first read failed (cut off from its
+     * party, or its sibling unreachable for a never-written `JoinedStrand`) would otherwise
+     * hear nothing until then.
+     */
+    scheduleReadRetry(readComplete) {
+        if (readComplete) {
+            this.readFailures = 0;
+            return;
+        }
+        this.readFailures++;
+        const delay = Math.min(this.retryBaseMs * 2 ** (this.readFailures - 1), this.readRetryCapMs);
+        log('Strand read incomplete (%d consecutive) - re-reading in %dms', this.readFailures, delay);
+        this.watch?.trigger(delay);
+    }
+    /**
+     * Read and reconcile. Resolves true when the read answered in full: false when it threw,
+     * or when the queryable answered part of it from a stand-in.
      */
     async poll() {
         if (!this.running)
-            return;
+            return true;
         try {
             const currentStrands = await this.queryable.queryStrands();
             const currentMap = new Map(currentStrands.map(s => [s.Id, s]));
@@ -96,7 +176,7 @@ export class StrandWatcher {
                 if (this.knownStrands.has(strand.Id))
                     continue;
                 const failure = this.failureStates.get(strand.Id);
-                // Clock read per candidate, not once per poll: an earlier strand's launch
+                // Clock read per candidate, not once per run: an earlier strand's launch
                 // may have taken a long time, and this one's gate must reflect that.
                 if (failure && this.now() < failure.nextAttemptAt)
                     continue; // backing off after a failed launch
@@ -104,11 +184,11 @@ export class StrandWatcher {
                 if (decision === 'reject')
                     continue;
                 log('Strand added: %s', strand.Id);
-                // Set BEFORE the await: this doubles as the in-flight guard that stops the
-                // interval timer from starting a second concurrent launch for the same strand.
+                // Set BEFORE the await: this doubles as the in-flight guard that stops a
+                // concurrent run (`forcePoll` beside a scheduled one) from launching the strand twice.
                 this.knownStrands.set(strand.Id, strand);
                 if (decision === 'defer') {
-                    // Provisional admission: sAppId unknown, re-check on later polls.
+                    // Provisional admission: sAppId unknown, re-check on later runs.
                     this.provisional.add(strand.Id);
                 }
                 try {
@@ -143,7 +223,7 @@ export class StrandWatcher {
                         log('Error handling strand remove for %s: %o', strandId, error);
                     }
                 }
-                // decision === 'defer': still unknown, leave provisional for next poll.
+                // decision === 'defer': still unknown, leave provisional until sAppIdLearned wakes a run.
             }
             // Find removed strands. A strand whose launch failed is no longer in
             // knownStrands, so it correctly never fires onStrandRemoved — nothing was
@@ -169,8 +249,8 @@ export class StrandWatcher {
                     this.failureStates.delete(strandId);
                 }
             }
-            // NOTE: the clear needs a poll that actually SEES the row absent, so a sibling that
-            // unpublishes and re-publishes a locally-stopped id inside one poll interval leaves
+            // NOTE: the clear needs a run that actually SEES the row absent, so a sibling that
+            // unpublishes and re-publishes a locally-stopped id between two runs leaves
             // it suppressed for the session. Contrived today — re-seating a removed id is
             // owner-gated and manual — and there is no row version to distinguish the new row
             // from the old. If re-publishing a removed id ever becomes routine, give the row a
@@ -180,15 +260,18 @@ export class StrandWatcher {
                     this.suppressed.delete(strandId);
                 }
             }
+            return !(this.queryable.lastReadPartial?.() ?? false);
         }
         catch (error) {
             // NOTE: a machine cut off from its party before it ever received the `Strand` block
-            // fails this read `cohort-unreachable` on every poll and logs here (observed in
-            // `control-cohort-edge-carries-data`). Harmless: nothing was ever launched from a block
-            // this machine never held, and this catch keeps the known set. Do not answer it as
-            // empty the way `ControlDatabase.queryRevokedStamps` does for `Revocation` — an empty
-            // answer here runs the removed-strand loop above. Revisit if the log volume matters.
+            // fails this read `cohort-unreachable` on every step of the read-retry ladder and logs
+            // here (observed in `control-cohort-edge-carries-data`). Harmless: nothing was ever
+            // launched from a block this machine never held, and this catch keeps the known set. Do
+            // not answer it as empty the way `ControlDatabase.queryRevokedStamps` does for
+            // `Revocation` — an empty answer here runs the removed-strand loop above. Revisit if
+            // the log volume matters.
             log('Error polling strands: %o', error);
+            return false;
         }
     }
     /**
@@ -200,19 +283,21 @@ export class StrandWatcher {
             return;
         }
         log('Starting StrandWatcher');
+        // Subscribed before the first read, so a commit landing between them is either seen by
+        // that read or wakes a follow-up run.
+        this.watch = this.subscribe();
         this.running = true;
-        // Set up periodic polling
-        this.pollTimer = setInterval(() => {
-            void this.poll();
-        }, this.pollInterval);
-        // Defer the first poll so start() doesn't block the caller.
-        // Strands added via addStrand() typically arrive after start() completes.
-        this.initialPollTimer = setTimeout(() => {
-            this.initialPollTimer = null;
-            void this.poll();
-        }, 100);
+        // Deferred so start() doesn't block the caller; strands added via addStrand()
+        // typically arrive after start() completes.
+        this.watch.trigger(INITIAL_RUN_DELAY_MS);
         log('StrandWatcher started');
     }
+    /** The watch every run goes through: the queryable's change subscription, or a timer-only one. */
+    subscribe() {
+        const onChange = () => this.runOnce();
+        const options = { label: 'strand-watcher', backstopMs: this.backstopMs };
+        return this.queryable.watchChanges?.(onChange, options) ?? scheduleRuns(onChange, options);
+    }
     /**
      * Stop watching for strand changes
      */
@@ -222,23 +307,20 @@ export class StrandWatcher {
         }
         log('Stopping StrandWatcher');
         this.running = false;
-        if (this.initialPollTimer) {
-            clearTimeout(this.initialPollTimer);
-            this.initialPollTimer = null;
-        }
-        if (this.pollTimer) {
-            clearInterval(this.pollTimer);
-            this.pollTimer = null;
-        }
+        // A run already in flight finishes; `running` keeps it from arming anything further.
+        this.watch?.dispose();
+        this.watch = null;
         this.knownStrands.clear();
         this.provisional.clear();
         this.failureStates.clear();
         this.suppressed.clear();
+        this.readFailures = 0;
         log('StrandWatcher stopped');
     }
     /**
-     * Forget a strand whose launch failed outside this watcher, so a later poll
-     * re-offers it — gated by the same backoff a watcher-driven failure gets.
+     * Forget a strand whose launch failed outside this watcher, so a later run
+     * re-offers it — gated by the same backoff a watcher-driven failure gets, and woken
+     * when that backoff expires.
      *
      * A failed launch normally leaves nothing running (StrandInstanceManager drops the
      * record), which is what makes re-offering it correct. One case does leave something
@@ -252,6 +334,25 @@ export class StrandWatcher {
         this.knownStrands.delete(strandId);
         this.provisional.delete(strandId);
         this.recordFailure(strandId);
+        if (this.running) {
+            this.scheduleLaunchRetry(this.now());
+        }
+    }
+    /**
+     * Re-read soon: something the queryable merges in beside the watched tables changed
+     * (`CadreNode`'s machine-local joined-strand records). A no-op once stopped.
+     */
+    refresh() {
+        this.watch?.trigger();
+    }
+    /**
+     * The host just learned `strandId`'s sAppId: if the strand was admitted provisionally
+     * under an `sAppId` filter, run so the admission resolves now rather than on the backstop.
+     */
+    sAppIdLearned(strandId) {
+        if (this.provisional.has(strandId)) {
+            this.watch?.trigger();
+        }
     }
     /**
      * Never offer this strand again this session. Two callers, both meaning "the retry
@@ -292,10 +393,13 @@ export class StrandWatcher {
         return new Map(this.knownStrands);
     }
     /**
-     * Force an immediate poll (useful for testing)
+     * Run once now, outside the watch's schedule (tests, and callers that just wrote a row
+     * and want this node to converge before returning). May overlap a scheduled run:
+     * `knownStrands` is updated before each callback's await, so neither launches nor
+     * removes a strand twice.
      */
     async forcePoll() {
-        await this.poll();
+        await this.runOnce();
     }
 }
 //# sourceMappingURL=strand-watcher.js.map

package/dist/strand-watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"strand-watcher.js","sourceRoot":"","sources":["../src/strand-watcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"strand-watcher.js","sourceRoot":"","sources":["../src/strand-watcher.ts"],"names":[],"mappings":"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"}

package/dist/table-change-watch.d.ts

@@ -0,0 +1,63 @@
+import type { Database } from '@quereus/quereus';
+import type { TimeoutScheduler } from './timeout-scheduler.js';
+/**
+ * Default coalescing window. One local commit fires the watch twice (Quereus's own
+ * post-commit dispatch, then the plugin's storage event); this folds both into one run.
+ */
+export declare const TABLE_CHANGE_COALESCE_MS = 50;
+export interface TableChangeWatchOptions {
+    /** Short label for log lines (e.g. 'strand-watcher'). */
+    label: string;
+    /** Coalescing window after the first change; default {@link TABLE_CHANGE_COALESCE_MS}. */
+    coalesceMs?: number;
+    /**
+     * Run anyway this long after the last run settled, change or not. Omit for none.
+     * The path for a change that arrives without a storage event (see the module doc).
+     */
+    backstopMs?: number;
+    /**
+     * Called inline, synchronously, from the watch handler — inside the committing call,
+     * possibly with the control write lock held — once per changed table per event, with the
+     * name as the consumer passed it. Only for setting a flag (cache invalidation). Must not
+     * read, write or await.
+     */
+    onInvalidate?: (qualifiedTable: string) => void;
+    /** Timer seam; default real, unref'd timers. */
+    scheduler?: TimeoutScheduler;
+}
+export interface TableChangeWatch {
+    /** Schedule a run after `delayMs` (default 0) through the same single-flight rule; an earlier pending run wins. */
+    trigger(delayMs?: number): void;
+    /** Stop: unsubscribe, clear timers; no run starts afterwards. Idempotent. Does not wait for a run in flight. */
+    dispose(): void;
+}
+/**
+ * Subscribe `onChange` to changes in `tables` (qualified `'Schema.Table'` names, e.g.
+ * `'CadreControl.Strand'`). Throws synchronously on a name that is not qualified, or a table
+ * that does not exist.
+ *
+ * NOTE: the plugin arms its storage bridge for a table on that table's first full
+ * initialization on this `Database`, so a table not yet touched hears local commits only,
+ * not replicated ones. Consumers' start runs touch their tables; the seam does not, because
+ * touching a never-written collection consults the network.
+ *
+ * NOTE: Quereus silently disposes a subscription whose table is dropped or altered. Control
+ * and strand schemas are fixed for a database's life (an app-schema attach adds `App` tables
+ * and alters no `Strand` one), so nothing re-subscribes; revisit if that stops holding.
+ */
+export declare function watchTables(db: Database, tables: readonly string[], onChange: () => Promise<void>, options: TableChangeWatchOptions): TableChangeWatch;
+/**
+ * {@link watchTables}' schedule — single-flight runs, `trigger`, the backstop — with no table
+ * subscription, for a consumer with no database to watch (tests, fakes).
+ */
+export declare function scheduleRuns(onChange: () => Promise<void>, options: TableChangeWatchOptions): TableChangeWatch;
+/**
+ * The subscriptions one database owner has handed out, so its `close()` can dispose those
+ * still live — synchronously, ahead of its own awaits, so nothing a closing commit does
+ * schedules a run. (`Database.close()` disposes them too, but only after its own awaits.)
+ */
+export declare class TableWatchRegistry {
+    private readonly live;
+    watch(db: Database, tables: readonly string[], onChange: () => Promise<void>, options: TableChangeWatchOptions): TableChangeWatch;
+    disposeAll(): void;
+}