charness 0.0.0-stage → 3.0.0

package/dist/requests/wakeUpEngine.js

@@ -0,0 +1,399 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestWakeUpEngine = exports.turnActivityPersistStepMs = exports.unwatchedSweepMs = exports.watchedTurnPollMs = void 0;
+const sessionKey_1 = require("../sessionKey");
+const requestHeader_1 = require("./requestHeader");
+const answerTail_1 = require("./answerTail");
+const wakeUpRules_1 = require("./wakeUpRules");
+/**
+ * @description The wake-up engine of the request/answer core (S4): it watches
+ * the turn each request (or reminder) started until that turn ends — one watch
+ * per REQUEST, so two requesters' open requests in one conversation are each
+ * followed to their own turn end (`requestGroup.ts`) — and runs a
+ * slower sweep over the open requests nobody is watching (the 15-minute
+ * follow-up after a progress note, and the backstop). Every decision is made by
+ * `wakeUpRules.ts`; this module only observes, persists and acts. The same sweep
+ * follows the agent's text after a final answer in a view that hides the stream
+ * (`answerTail.ts`), and reminds the agent once when that text is worth it.
+ *
+ * No adapter emits a turn-end event, so turns are POLLED through the injected
+ * `probeTurn` (the precedent is the deferred-compaction poll). The watch state is
+ * in memory: after a restart the persisted request times drive the sweep, and the
+ * backstop covers a turn whose tracking was lost.
+ *
+ * A wake-up is a reminder forwarded into the SAME session — never a request.
+ * The answer tails are in memory as well: a restart forgets them.
+ */
+/** How often a watched turn is polled for its end. */
+exports.watchedTurnPollMs = 10_000;
+/** How often the unwatched open requests are swept (follow-ups, backstop). */
+exports.unwatchedSweepMs = 60_000;
+/** A live turn's activity is persisted at most this often (it pushes the backstop back). */
+exports.turnActivityPersistStepMs = 60_000;
+class RequestWakeUpEngine {
+    deps;
+    now;
+    /** The watched turns by REQUEST id (a conversation may hold one per requester). */
+    watched = new Map();
+    /** Last persisted live-turn activity per request id, for the persist step. */
+    activityPersistedAt = new Map();
+    /** The tail after the latest final answer, by serialized conversation key. */
+    answerTails = new Map();
+    /** The request whose tail was last reminded and how often, by serialized conversation key (the reminder cap). */
+    answerTailReminders = new Map();
+    pollTimer = null;
+    sweepTimer = null;
+    isPolling = false;
+    isSweeping = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+    }
+    /**
+     * @description Start the poll and sweep timers (unref'd: they never keep the
+     * process alive). A rejected tick is logged: unhandled, it would end the whole
+     * process (Node's default for an unhandled rejection).
+     */
+    start() {
+        this.pollTimer ??= setInterval(() => {
+            void this.pollWatchedTurns().catch((e) => logWakeUpFailure('the watched-turn poll', e));
+        }, exports.watchedTurnPollMs);
+        this.sweepTimer ??= setInterval(() => {
+            void this.sweepUnwatchedRequests().catch((e) => logWakeUpFailure('the open-request sweep', e));
+        }, exports.unwatchedSweepMs);
+        this.pollTimer.unref?.();
+        this.sweepTimer.unref?.();
+    }
+    /** @description Stop both timers (shutdown). The persisted request times survive. */
+    stop() {
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        if (this.sweepTimer)
+            clearInterval(this.sweepTimer);
+        this.pollTimer = null;
+        this.sweepTimer = null;
+    }
+    /** The open request `requestId` when it belongs to `key`'s conversation, else `undefined`. */
+    getOpenRequestOf(key, requestId) {
+        const entry = this.deps.ledger.getOpenRequestById(requestId);
+        return entry && (0, sessionKey_1.keyToString)(entry.key) === (0, sessionKey_1.keyToString)(key) ? entry.request : undefined;
+    }
+    /** The watched turns of `key`'s conversation. */
+    getWatchedTurnsOf(key) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        return [...this.watched.values()].filter((turn) => (0, sessionKey_1.keyToString)(turn.key) === conversationKey);
+    }
+    /**
+     * @description A request's message (or a reminder for it) was just forwarded to
+     * the conversation's session: watch the turn it starts. A watch already there
+     * for the SAME request is replaced — its newest message is the one that counts;
+     * another requester's request in the conversation keeps its own watch. A post
+     * retry still pending is moot from now on (R28): the session has the request.
+     */
+    async trackForwardedTurn(key, requestId, options = { isRequestPrompt: false }) {
+        const request = this.getOpenRequestOf(key, requestId);
+        if (!request)
+            return;
+        // The agent works on an open request now: what it writes is owed to that one, not a tail.
+        this.answerTails.delete((0, sessionKey_1.keyToString)(key));
+        this.watched.set(requestId, {
+            key,
+            requestId,
+            progressCountAtTurnStart: request.progressAnswerCount,
+            hasSeenBusy: false,
+            hasSeenOutput: false,
+            isRequestPrompt: options.isRequestPrompt,
+        });
+        if (request.nextPostRetryAt !== undefined)
+            await this.deps.ledger.updateOpenRequest(request.id, { nextPostRetryAt: undefined });
+        await this.recordTurnActivity(request, true);
+    }
+    /**
+     * @description The request's prompt could not be posted to the session (no
+     * session came up, the forward failed): try again soon (R28). Once the retries
+     * are spent nothing is scheduled — the backstop and its alert take over. Never
+     * rejects: its caller is a post that already failed.
+     */
+    async notePostFailed(key, requestId) {
+        const request = this.getOpenRequestOf(key, requestId);
+        if (!request)
+            return;
+        const retry = (0, wakeUpRules_1.getPostRetryUpdate)(request, this.now());
+        if (!retry)
+            return;
+        try {
+            await this.deps.ledger.updateOpenRequest(request.id, retry);
+        }
+        catch (e) {
+            logWakeUpFailure(`scheduling a post retry of ${request.id}`, e);
+        }
+    }
+    /** @description The agent produced output in this conversation (a turn is under way). */
+    noteAgentOutput(key) {
+        for (const turn of this.getWatchedTurnsOf(key))
+            turn.hasSeenOutput = true;
+    }
+    /**
+     * @description An answer to `requestId` was delivered. Any answer ends the
+     * tail of the one before: the agent spoke to the requester. A final answer
+     * starts a fresh tail where the view hides the stream, unless its request
+     * already had all its reminders.
+     */
+    noteAnswerDelivered(key, requestId, kind) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        this.answerTails.delete(conversationKey);
+        if (kind !== 'final')
+            return;
+        const reminded = this.answerTailReminders.get(conversationKey);
+        if (reminded?.requestId === requestId && reminded.count >= answerTail_1.answerTailMaxReminders)
+            return;
+        if (this.deps.checkIsAnswerTailWatched?.(key) !== true)
+            return;
+        this.answerTails.set(conversationKey, { key, tail: (0, answerTail_1.createAnswerTail)(requestId, this.now()) });
+    }
+    /** @description The agent wrote text of its own in this conversation (not a sub-agent's, not a block the bot made). */
+    noteAnswerTailOutput(key) {
+        const entry = this.answerTails.get((0, sessionKey_1.keyToString)(key));
+        if (entry)
+            entry.tail = (0, answerTail_1.addAnswerTailOutput)(entry.tail, this.now());
+    }
+    /** Drop every watch of `key`'s conversation, its answer tail included. */
+    unwatchConversation(key) {
+        for (const turn of this.getWatchedTurnsOf(key))
+            this.watched.delete(turn.requestId);
+        this.answerTails.delete((0, sessionKey_1.keyToString)(key));
+    }
+    /**
+     * @description The person took over (interrupted, quit, restarted, switched or
+     * resumed the session, left the folder): every open request of the
+     * conversation closes silently and nothing wakes them.
+     */
+    async cancelConversation(key) {
+        this.unwatchConversation(key);
+        for (const request of this.deps.ledger.listOpenRequestsOf(key))
+            await this.deps.ledger.closeRequest(request.id, 'cancelled');
+    }
+    /**
+     * @description The bot itself forwarded a "continue" nudge into the session (an
+     * API-error retry fired, or a usage-limit wait ended): watch the turn it starts
+     * as a fresh one, so the idle the error left behind is never read as its end.
+     * `isCountersReset` (the end of a limit wait) starts every open request's
+     * wake-up bookkeeping from zero — the wait was not the agent's silence — and
+     * lifts a limit stop: the work continues, so does the waking. A request the
+     * rules already gave up on stays given up. The one session turn the nudge
+     * starts is watched for every open request of the conversation.
+     */
+    async trackContinuationTurn(key, options) {
+        for (const request of this.deps.ledger.listOpenRequestsOf(key)) {
+            if (options.isCountersReset) {
+                await this.deps.ledger.updateOpenRequest(request.id, {
+                    silentTurnCount: 0,
+                    wakeCount: 0,
+                    nextWakeAt: undefined,
+                    isLimitStopped: undefined,
+                    limitWaitAnsweredFor: undefined,
+                });
+            }
+            await this.trackForwardedTurn(key, request.id, { isRequestPrompt: options.isRequestPrompt === true });
+        }
+    }
+    /**
+     * @description A usage-limit wait will not end by itself (auto-resume is off,
+     * the operator skipped or disabled this resume, or the bot gave up after its
+     * last attempt): nothing wakes the open request, the backstop included — a
+     * reminder would only spend an attempt against the same limit — until a limit
+     * wait ends with a resume or the operator's next message supersedes it. Never
+     * rejects: its callers are command handlers and the error path, and a failed
+     * write is logged instead.
+     */
+    async stopWakingForLimitWait(key) {
+        this.unwatchConversation(key);
+        for (const request of this.deps.ledger.listOpenRequestsOf(key)) {
+            try {
+                await this.deps.ledger.updateOpenRequest(request.id, { isLimitStopped: true, nextWakeAt: undefined });
+            }
+            catch (e) {
+                logWakeUpFailure(`stopping the wake-ups of ${request.id}`, e);
+            }
+        }
+    }
+    /** @description One poll over the watched turns; exported for tests (the timer calls it). */
+    async pollWatchedTurns() {
+        if (this.isPolling)
+            return;
+        this.isPolling = true;
+        try {
+            for (const turn of [...this.watched.values()]) {
+                // One request's failure must not stop the others from being polled.
+                await this.pollWatchedTurn(turn).catch((e) => logWakeUpFailure(`polling ${turn.requestId}`, e));
+            }
+        }
+        finally {
+            this.isPolling = false;
+        }
+    }
+    async pollWatchedTurn(turn) {
+        // Replaced or dropped since this poll took its snapshot: the newer watch (if any) decides.
+        if (this.watched.get(turn.requestId) !== turn)
+            return;
+        const request = this.getOpenRequestOf(turn.key, turn.requestId);
+        if (!request) {
+            // Answered, cancelled or superseded meanwhile — nothing left to watch.
+            this.watched.delete(turn.requestId);
+            return;
+        }
+        const probe = this.deps.probeTurn(turn.key);
+        if (probe.isBusy)
+            turn.hasSeenBusy = true;
+        if (turn.isRequestPrompt && request.isPromptTakenIn !== true && probe.isActive && (0, wakeUpRules_1.checkIsTurnInputConsumed)(turn, probe)) {
+            // R21: from now on a wake-up is a reminder — the agent has read the request.
+            await this.deps.ledger.updateOpenRequest(request.id, { isPromptTakenIn: true });
+        }
+        const turnState = (0, wakeUpRules_1.getWatchedTurnState)(turn, probe);
+        if (turnState === 'running') {
+            if (probe.isBusy)
+                await this.recordTurnActivity(request, false);
+            // Its end can no longer be seen: the sweep's backstop takes the request over.
+            else if ((0, wakeUpRules_1.checkIsWatchedTurnStale)(request, probe, this.now(), this.deps.backstopMs))
+                this.watched.delete(turn.requestId);
+            return;
+        }
+        this.watched.delete(turn.requestId);
+        // A dead session is not a turn end: the backstop resumes it later.
+        if (turnState === 'sessionGone')
+            return;
+        await this.applyDecision(turn.key, request, (0, wakeUpRules_1.decideTurnEnd)(request, turn.progressCountAtTurnStart, this.now()));
+    }
+    /** @description One sweep over the open requests nobody watches; exported for tests. */
+    async sweepUnwatchedRequests() {
+        if (this.isSweeping)
+            return;
+        this.isSweeping = true;
+        try {
+            const openRequests = this.deps.ledger.listOpenRequests();
+            const openIds = new Set(openRequests.map(({ request }) => request.id));
+            for (const requestId of [...this.activityPersistedAt.keys()]) {
+                if (!openIds.has(requestId))
+                    this.activityPersistedAt.delete(requestId);
+            }
+            for (const { key, request } of openRequests) {
+                if (this.watched.has(request.id))
+                    continue;
+                // One conversation's failure must not stop the others from being swept.
+                await this.sweepOpenRequest(key, request).catch((e) => logWakeUpFailure(`sweeping ${(0, sessionKey_1.keyToString)(key)}`, e));
+            }
+            for (const [conversationKey, entry] of [...this.answerTails]) {
+                await this.sweepAnswerTail(conversationKey, entry).catch((e) => logWakeUpFailure(`the answer tail of ${conversationKey}`, e));
+            }
+        }
+        finally {
+            this.isSweeping = false;
+        }
+    }
+    async sweepOpenRequest(key, request) {
+        const probe = this.deps.probeTurn(key);
+        if (probe.isBusy) {
+            await this.recordTurnActivity(request, false);
+            return;
+        }
+        await this.applyDecision(key, request, (0, wakeUpRules_1.decideUnwatchedRequest)(request, probe, this.now(), this.deps.backstopMs));
+    }
+    async sweepAnswerTail(conversationKey, entry) {
+        if (this.answerTails.get(conversationKey) !== entry)
+            return;
+        if (this.deps.checkIsAnswerTailWatched?.(entry.key) !== true || this.deps.ledger.listOpenRequestsOf(entry.key).length > 0) {
+            // The stream is shown again, or a newer request is open and its own answer is owed.
+            this.answerTails.delete(conversationKey);
+            return;
+        }
+        const decision = (0, answerTail_1.decideAnswerTail)(entry.tail, this.deps.probeTurn(entry.key), this.now());
+        if (decision === 'wait')
+            return;
+        this.answerTails.delete(conversationKey);
+        if (decision === 'drop')
+            return;
+        const { requestId } = entry.tail;
+        const reminded = this.answerTailReminders.get(conversationKey);
+        this.answerTailReminders.set(conversationKey, { requestId, count: reminded?.requestId === requestId ? reminded.count + 1 : 1 });
+        const isDelivered = (await this.deps.remindAnswerTail?.(entry.key, (0, answerTail_1.buildAnswerTailReminder)(requestId))) ?? false;
+        console.log(`[requests] answer-tail reminder for ${requestId} ${isDelivered ? 'forwarded' : 'NOT delivered (the session could not be reached)'}`);
+    }
+    /** Persist that the agent is working on it, at most once per step unless forced. */
+    async recordTurnActivity(request, isForced) {
+        const nowMs = this.now();
+        const persistedAt = this.activityPersistedAt.get(request.id);
+        if (!isForced && persistedAt !== undefined && nowMs - persistedAt < exports.turnActivityPersistStepMs)
+            return;
+        this.activityPersistedAt.set(request.id, nowMs);
+        await this.deps.ledger.updateOpenRequest(request.id, { lastTurnActivityAt: nowMs });
+    }
+    async applyDecision(key, request, decision) {
+        if (decision.kind === 'none')
+            return;
+        let isStoppedMeanwhile = false;
+        const updated = await this.deps.ledger.updateOpenRequest(request.id, (current) => {
+            // `request` is a snapshot: a limit wait may have stopped the wake-ups since (no alert either).
+            isStoppedMeanwhile = (0, wakeUpRules_1.checkIsWakingStopped)(current);
+            return isStoppedMeanwhile ? {} : decision.update;
+        });
+        // Closed or superseded while we decided: the decision belonged to the old one.
+        if (!updated || isStoppedMeanwhile)
+            return;
+        if (decision.kind === 'followUpLater')
+            return;
+        if (decision.kind === 'alert') {
+            await this.raiseAlert(key, updated, decision.reason);
+            return;
+        }
+        const message = (0, requestHeader_1.getWakeUpMessage)(updated, decision.reason);
+        const outcome = await this.deliverWakeUpSafely(key, updated, message);
+        if (outcome === 'delivered') {
+            await this.trackForwardedTurn(key, updated.id, { isRequestPrompt: message.isRequestPrompt });
+            return;
+        }
+        if (outcome === 'requestGone')
+            return;
+        if (decision.reason === 'postRetry') {
+            // R28: a retry that failed again tries later; once spent, the backstop decides — no alert yet.
+            const retry = (0, wakeUpRules_1.getPostRetryUpdate)(updated, this.now());
+            if (retry)
+                await this.deps.ledger.updateOpenRequest(updated.id, retry);
+            return;
+        }
+        const stopped = await this.deps.ledger.updateOpenRequest(updated.id, { isWakeStopped: true, nextWakeAt: undefined });
+        if (stopped)
+            await this.raiseAlert(key, stopped, 'wakeFailed');
+    }
+    /**
+     * Resume the session if needed, re-check the request, forward the reminder. A
+     * step that threw did not reach the session: same as one that could not.
+     */
+    async deliverWakeUpSafely(key, request, message) {
+        try {
+            if (!(await this.deps.prepareWakeUpSession(key, message)))
+                return 'failed';
+            // The resume took a while: a reminder for a request that closed, was replaced
+            // or stopped being woken meanwhile is stale.
+            const current = this.getOpenRequestOf(key, request.id);
+            if (!current || (0, wakeUpRules_1.checkIsWakingStopped)(current))
+                return 'requestGone';
+            await this.deps.forwardWakeUp(key, request, message);
+            return 'delivered';
+        }
+        catch (e) {
+            logWakeUpFailure(`delivering the reminder for ${request.id}`, e);
+            return 'failed';
+        }
+    }
+    async raiseAlert(key, request, reason) {
+        const alertRef = await this.deps.deliverAlert(key, request, reason);
+        if (alertRef !== null)
+            await this.deps.ledger.recordAlert(key, request.id, alertRef);
+    }
+}
+exports.RequestWakeUpEngine = RequestWakeUpEngine;
+/** Log a wake-up step that failed; the engine keeps running for every other request. */
+function logWakeUpFailure(step, error) {
+    console.warn(`[requests] ${step} failed:`, error instanceof Error ? error.message : error);
+}
+//# sourceMappingURL=wakeUpEngine.js.map

package/dist/requests/wakeUpEngine.js.map

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

package/dist/requests/wakeUpRules.d.ts

@@ -0,0 +1,151 @@
+import type { OpenRequestState, OpenRequestUpdate, RequestAlertReason, RequestWakeUpReason } from './types';
+/**
+ * @description The wake-up rules of the request/answer core (S4), as pure
+ * decisions over an open request and what the session looks like right now:
+ *
+ *   turn ends, request still open
+ *     └─ the turn sent NO answer      → silent-turn counter +1
+ *          counter < 2                → wake the same session at once
+ *          counter = 2                → alert a person, stop waking
+ *     └─ the turn sent a progress     → counter = 0, wake again after 15 min
+ *   cap: 10 wake-ups per request      → alert, stop waking (loop guard)
+ *   backstop: nothing seen working on it for 90 min (a dead process, tracking
+ *             lost across a restart or a watch that never saw its turn end)
+ *                                     → resume / wake the session
+ *
+ * A wake-up never interrupts a live turn and never starts while the session is
+ * blocked on something that is not a turn end (a pending native question, a
+ * compaction, an armed API-error retry or usage-limit wait). After the alert or
+ * the cap nothing wakes the request again until it closes or is superseded.
+ */
+/** Silent turns in a row that make the rules give up. */
+export declare const maxSilentTurns = 2;
+/** Wake-ups one request may receive before the loop guard gives up. */
+export declare const maxWakeUpsPerRequest = 10;
+/** After a progress answer, how long before the agent is reminded again. */
+export declare const progressFollowUpDelayMs: number;
+/**
+ * After a request's prompt could not be posted (no session, a forward that
+ * failed), when to try again (R28): soon, then less soon — these retries are not
+ * wake-ups of a silent agent, so they do not count against the wake-up cap.
+ */
+export declare const postRetryDelaysMs: readonly [number, number, number];
+/**
+ * @description The next post retry after a failed post (R28), or `null` once the
+ * retries are spent — the normal backstop / alert rules take the request then.
+ */
+export declare function getPostRetryUpdate(request: OpenRequestState, nowMs: number): OpenRequestUpdate | null;
+/** Default backstop: open with nothing seen working on it for this long. */
+export declare const defaultRequestBackstopMs: number;
+/**
+ * @description The backstop window, honouring the `REQUEST_BACKSTOP_MINUTES`
+ * override (a live test shortens it to finish a killed-process scenario in
+ * minutes). A missing, non-numeric or non-positive value keeps the default.
+ */
+export declare function getRequestBackstopMs(overrideMinutes: string | undefined): number;
+/**
+ * @name SessionTurnProbe
+ * @description What the session of a conversation looks like right now.
+ * `hasUnconsumedInput` is `null` for a backend that cannot tell (tmux Claude).
+ */
+export interface SessionTurnProbe {
+    isActive: boolean;
+    isBusy: boolean;
+    hasUnconsumedInput: boolean | null;
+    /**
+     * A pending native question, a compaction, an armed retry / limit wait, a
+     * wedged-turn recovery in flight, a retry whose "continue" nudge is on its way,
+     * or a session start under way.
+     */
+    isTurnEndBlocked: boolean;
+}
+/**
+ * @name WakeUpDecision
+ * @description What to do for an open request, and the bookkeeping to persist
+ * with it (`update`, applied before the action runs).
+ */
+export type WakeUpDecision = {
+    kind: 'none';
+} | {
+    kind: 'wake';
+    reason: RequestWakeUpReason;
+    update: OpenRequestUpdate;
+} | {
+    kind: 'followUpLater';
+    update: OpenRequestUpdate;
+} | {
+    kind: 'alert';
+    reason: RequestAlertReason;
+    update: OpenRequestUpdate;
+};
+/**
+ * @description Whether anything may still wake the request: the rules' own
+ * give-up (`isWakeStopped`, for good) and a limit stop (`isLimitStopped`, until a
+ * limit wait ends with a resume) both say no.
+ */
+export declare function checkIsWakingStopped(request: OpenRequestState): boolean;
+/**
+ * @description The decision at the end of a turn the request's message started.
+ * `progressCountAtTurnStart` is the request's progress-answer count when the
+ * turn began, so an increase means this turn sent a progress note (a `question`
+ * or `final` would have closed the request — there is nothing to decide then).
+ */
+export declare function decideTurnEnd(request: OpenRequestState, progressCountAtTurnStart: number, nowMs: number): WakeUpDecision;
+/**
+ * @description The periodic decision for an open request whose turn is NOT being
+ * watched: a due progress follow-up, or the backstop. Never while the session is
+ * working or blocked — and a live turn counts as activity, which pushes the
+ * backstop back (the caller records it).
+ */
+export declare function decideUnwatchedRequest(request: OpenRequestState, probe: SessionTurnProbe, nowMs: number, backstopMs: number): WakeUpDecision;
+/**
+ * @name WatchedTurn
+ * @description The in-memory view of a turn started by a request's message (or
+ * by a wake-up reminder), until it ends.
+ */
+export interface WatchedTurn {
+    requestId: string;
+    progressCountAtTurnStart: number;
+    /** Busy was observed since the forward (the backend started on it). */
+    hasSeenBusy: boolean;
+    /** The agent produced output since the forward. */
+    hasSeenOutput: boolean;
+    /** The turn carries the request's own prompt (not a reminder or a "continue" nudge) — R21. */
+    isRequestPrompt: boolean;
+}
+/**
+ * @name WatchedTurnState
+ * @description Where a watched turn stands: still running (or not started on
+ * our message yet), ended, or gone (the session is no longer active — the
+ * backstop takes over). A session not active while something holds its turn
+ * open — its START under way, a recovery restarting it — is coming, not gone:
+ * the message forwarded to it waits in the startup buffer and replays once the
+ * session is up, so the watch must survive to see THAT turn end. Dropped, the
+ * replayed turn would run unwatched: a silent one would wait for the backstop
+ * (90 min) instead of its wake-up, and a backstop wake re-posts the request.
+ */
+export type WatchedTurnState = 'running' | 'ended' | 'sessionGone';
+/**
+ * @description Has the backend taken in what was forwarded for this turn? Its own
+ * signal when it has one (nothing written is still unread), else busy or output
+ * seen since the forward.
+ */
+export declare function checkIsTurnInputConsumed(turn: WatchedTurn, probe: SessionTurnProbe): boolean;
+/**
+ * @description Has the turn the request's message started ended? The backend
+ * must first have TAKEN IN the message — otherwise an idle reported for the
+ * earlier turn would read as this turn's end: a backend that tracks it says so
+ * (`hasUnconsumedInput`), one that does not must have been seen busy or
+ * producing output since the forward (the busy-onset race).
+ */
+export declare function getWatchedTurnState(turn: WatchedTurn, probe: SessionTurnProbe): WatchedTurnState;
+/**
+ * @description Has a watched turn that is still `running` lost its tracking? It
+ * is idle, nothing holds it open, and nothing was seen working on the request
+ * for the whole backstop window — so what keeps it `running` is a consumption
+ * signal that never settled (an input counter left behind, a turn start never
+ * seen). Dropping the watch hands the request to the backstop: a watch that
+ * stayed forever would silence every wake-up and alert of the request.
+ */
+export declare function checkIsWatchedTurnStale(request: OpenRequestState, probe: SessionTurnProbe, nowMs: number, backstopMs: number): boolean;
+//# sourceMappingURL=wakeUpRules.d.ts.map

package/dist/requests/wakeUpRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeUpRules.d.ts","sourceRoot":"","sources":["../../src/requests/wakeUpRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG5G;;;;;;;;;;;;;;;;;;GAkBG;AAEH,yDAAyD;AACzD,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AACtD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,mCAAsD,CAAC;AAErF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAIrG;AAED,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAEvE;AAyBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAaxH;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,cAAc,CAehB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;IACjC,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,8FAA8F;IAC9F,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAE5F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAIhG;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAGT"}