charness 0.0.0-stage → 3.0.0

package/dist/requests/requestLedger.js

@@ -0,0 +1,468 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestLedger = exports.RequestLedgerNotLoadedError = exports.closedRequestIndexMaxSize = exports.supersededRequestIdsMaxLength = exports.requestPromptMaxLength = exports.requestHistoryMaxBytes = void 0;
+exports.parseClosedRequestLine = parseClosedRequestLine;
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const sessionKey_1 = require("../sessionKey");
+const state_1 = require("../state");
+const rotatingJsonlFile_1 = require("../utils/rotatingJsonlFile");
+const requestGroup_1 = require("./requestGroup");
+/**
+ * @description The request ledger (core plan S2): which unit of work each
+ * conversation's agent still owes an answer to.
+ *
+ *   open set  — `state.json` `openRequests`, at most ONE per request GROUP
+ *               (`requestGroup.ts`: the platform-agnostic `SessionKey` of the
+ *               conversation — Telegram topics and tracker issues alike — plus
+ *               the requester). A new request SUPERSEDES the group's open one;
+ *               other requesters' requests in the conversation stay open.
+ *   history   — `DATA_DIR/requests.jsonl`, one line per CLOSED request
+ *               (append-only, one rotated backup).
+ *
+ * A recently closed request stays known by id — an answer to it is still
+ * delivered, it just changes no request — so the history is indexed in memory
+ * at {@link RequestLedger.load}, bounded to the most recent
+ * {@link closedRequestIndexMaxSize} closed requests. A new request is durably
+ * saved before its id is handed out. Until the load resolves the ledger refuses every call
+ * (it throws): the bot MCP server starts serving before sessions re-attach, and
+ * an answer looked up against a not-yet-loaded history would wrongly be refused
+ * as an unknown id. Tool handlers gate on {@link RequestLedger.whenLoaded}.
+ *
+ * Crash ordering: the history line is written BEFORE the open entry is dropped,
+ * and `load` drops any open entry the history already shows closed — so a crash
+ * between the two writes never leaves a request both open and closed.
+ */
+/** History size bound per file before it rolls to `.1` (same as the run ledger). */
+exports.requestHistoryMaxBytes = 10 * 1024 * 1024;
+/** The longest prompt an open request keeps for a re-post (R21); `state.json` is rewritten whole. */
+exports.requestPromptMaxLength = 64_000;
+/** Request ids read `req_<random>`: short enough for a prompt header, unguessable across topics. */
+const requestIdPrefix = 'req_';
+/** 6 random bytes → 8 base64url chars, 48 bits. */
+const requestIdRandomByteLength = 6;
+/**
+ * How many replaced ids a request carries (`supersededRequestIds`): a requester
+ * who keeps writing without an answer in between builds a chain, and the header
+ * naming it must stay short. The newest ones are kept.
+ */
+exports.supersededRequestIdsMaxLength = 10;
+/**
+ * How many CLOSED requests stay known by id (the most recent ones). A closed id
+ * is looked up only for a late answer — a turn still running when a newer
+ * request superseded its own — which arrives minutes, at most hours (a usage
+ * limit wait) after the close. 5 000 covers weeks of traffic even with every
+ * operator message a request (a few hundred a day), while keeping memory fixed
+ * (~1–2 MB) regardless of how long the bot runs. An answer to an id that fell
+ * out of the window is refused as unknown.
+ */
+exports.closedRequestIndexMaxSize = 5_000;
+/** Thrown when the ledger is used before {@link RequestLedger.load} resolved. */
+class RequestLedgerNotLoadedError extends Error {
+    constructor() {
+        super('request ledger used before load() resolved');
+        this.name = 'RequestLedgerNotLoadedError';
+    }
+}
+exports.RequestLedgerNotLoadedError = RequestLedgerNotLoadedError;
+const closeReasons = new Set(['final', 'question', 'superseded', 'cancelled']);
+const originKinds = new Set(['message', 'scheduledRun', 'trackerEvent']);
+/** Default history path under the live `DATA_DIR`. */
+function getDefaultHistoryPath() {
+    return node_path_1.default.join((0, state_1.resolveDataDir)(), 'requests.jsonl');
+}
+/**
+ * @description Parse one history line, or `null` for a line that is not a
+ * closed request (truncated by a crash, hand-edited, written by a different
+ * version). Every field is checked and the record rebuilt from them.
+ */
+function parseClosedRequestLine(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const { id, conversationKey, closedAt, closeReason, origin, createdAt, progressAnswerCount, silentTurnCount, wakeCount, isWakeStopped, nextWakeAt, lastTurnActivityAt, alertRef, isLimitStopped, limitWaitAnsweredFor, supersededBy, supersededRequestIds, } = parsed;
+    if (typeof id !== 'string' || typeof conversationKey !== 'string')
+        return null;
+    if (closeReason === undefined || !closeReasons.has(closeReason))
+        return null;
+    if (typeof origin !== 'object' || origin === null || !originKinds.has(origin.kind))
+        return null;
+    const { attributes } = origin;
+    // The answer sink of a closed request's platform reads these back verbatim.
+    if (typeof attributes !== 'object' || attributes === null || Array.isArray(attributes))
+        return null;
+    if (!Object.values(attributes).every((value) => typeof value === 'string'))
+        return null;
+    if (typeof closedAt !== 'number' || typeof createdAt !== 'number' || typeof progressAnswerCount !== 'number' ||
+        typeof silentTurnCount !== 'number' || typeof wakeCount !== 'number' || typeof isWakeStopped !== 'boolean') {
+        return null;
+    }
+    return {
+        id,
+        conversationKey,
+        closedAt,
+        closeReason,
+        origin: { kind: origin.kind, attributes },
+        createdAt,
+        progressAnswerCount,
+        silentTurnCount,
+        wakeCount,
+        isWakeStopped,
+        // Optional fields keep their absence (`state.json` omits them when unset).
+        ...(typeof nextWakeAt === 'number' ? { nextWakeAt } : {}),
+        ...(typeof lastTurnActivityAt === 'number' ? { lastTurnActivityAt } : {}),
+        ...(typeof alertRef === 'string' ? { alertRef } : {}),
+        ...(typeof isLimitStopped === 'boolean' ? { isLimitStopped } : {}),
+        ...(typeof limitWaitAnsweredFor === 'string' ? { limitWaitAnsweredFor } : {}),
+        ...(typeof supersededBy === 'string' ? { supersededBy } : {}),
+        ...(Array.isArray(supersededRequestIds) && supersededRequestIds.every((value) => typeof value === 'string')
+            ? { supersededRequestIds }
+            : {}),
+    };
+}
+class RequestLedger {
+    store;
+    history;
+    now;
+    closedIndexMaxSize;
+    releaseAlert;
+    onRequestCreated;
+    onPromptSettled;
+    /** Request ids whose alert release is under way, so two paths never release one twice at once. */
+    alertReleasesInFlight = new Set();
+    /** Insertion order = close order, so the first key is always the oldest. */
+    closedById = new Map();
+    loadPromise = null;
+    isLoaded = false;
+    resolveLoaded = () => { };
+    loadedPromise = new Promise((resolve) => {
+        this.resolveLoaded = resolve;
+    });
+    constructor(deps) {
+        this.store = deps.store;
+        this.history = deps.history ?? new rotatingJsonlFile_1.RotatingJsonlFile(getDefaultHistoryPath(), exports.requestHistoryMaxBytes);
+        this.now = deps.now ?? Date.now;
+        this.closedIndexMaxSize = deps.closedIndexMaxSize ?? exports.closedRequestIndexMaxSize;
+        this.releaseAlert = deps.releaseAlert;
+        this.onRequestCreated = deps.onRequestCreated;
+        this.onPromptSettled = deps.onPromptSettled;
+    }
+    /**
+     * @description Index the closed-request history and drop open entries it
+     * already shows closed. Idempotent: every call returns the same promise. A
+     * history that cannot be read rejects (the boot surfaces it) and leaves the
+     * ledger unloaded rather than serving a partial index as the truth.
+     */
+    load() {
+        this.loadPromise ??= this.runLoad();
+        return this.loadPromise;
+    }
+    /** @description Resolves once {@link load} has finished; never rejects. */
+    whenLoaded() {
+        return this.loadedPromise;
+    }
+    /** @description True once {@link load} has finished. */
+    checkIsLoaded() {
+        return this.isLoaded;
+    }
+    async runLoad() {
+        let skippedLineCount = 0;
+        for (const line of await this.history.readLines()) {
+            const record = parseClosedRequestLine(line);
+            if (record)
+                this.indexClosed(record);
+            else
+                skippedLineCount += 1;
+        }
+        let droppedOpenCount = 0;
+        for (const entry of this.getOpenEntries()) {
+            if (!this.closedById.has(entry.request.id))
+                continue;
+            // It closed before the crash, so its alert was never handed to a release.
+            // Listed BEFORE the entry goes, so no crash between the two can lose it.
+            const { alertRef } = entry.request;
+            if (alertRef !== undefined) {
+                this.store.addUnreleasedRequestAlert(entry.request.id, { conversationKey: (0, sessionKey_1.keyToString)(entry.key), alertRef });
+            }
+            await this.store.updateOpenRequest(entry.group, (current) => (current?.id === entry.request.id ? undefined : current));
+            droppedOpenCount += 1;
+        }
+        this.isLoaded = true;
+        this.resolveLoaded();
+        for (const [requestId, alert] of Object.entries(this.store.getUnreleasedRequestAlerts())) {
+            void this.releaseAlertOf(requestId, alert);
+        }
+        console.log(`[requests] ledger loaded: ${this.getOpenEntries().length} open, ${this.closedById.size} recently closed known` +
+            (droppedOpenCount > 0 ? `, ${droppedOpenCount} open entries already closed dropped` : '') +
+            (skippedLineCount > 0 ? `, ${skippedLineCount} unreadable history lines skipped` : ''));
+    }
+    assertLoaded() {
+        if (!this.isLoaded)
+            throw new RequestLedgerNotLoadedError();
+    }
+    /** Open entries whose group key still decodes (a key of an unregistered platform is left alone), oldest first. */
+    getOpenEntries() {
+        const entries = [];
+        for (const [groupString, request] of Object.entries(this.store.getOpenRequests())) {
+            const group = (0, requestGroup_1.tryRequestGroupKeyFromString)(groupString);
+            if (group)
+                entries.push({ key: group.conversation, group, request });
+        }
+        return entries.sort((a, b) => a.request.createdAt - b.request.createdAt);
+    }
+    getOpenEntryById(id) {
+        return this.getOpenEntries().find((entry) => entry.request.id === id);
+    }
+    createRequestId() {
+        const openIds = new Set(Object.values(this.store.getOpenRequests()).map((request) => request.id));
+        for (;;) {
+            const id = `${requestIdPrefix}${(0, node_crypto_1.randomBytes)(requestIdRandomByteLength).toString('base64url')}`;
+            if (!openIds.has(id) && !this.closedById.has(id))
+                return id;
+        }
+    }
+    /** A close settles the prompt unless it was already taken in: by its own answer it was, otherwise it was dropped. */
+    getCloseOutcome(closing) {
+        if (closing.isPromptTakenIn === true)
+            return null;
+        return closing.closeReason === 'final' || closing.closeReason === 'question' ? 'takenIn' : 'dropped';
+    }
+    notePromptSettled(key, settled) {
+        for (const { requestId, outcome } of settled)
+            this.onPromptSettled?.(key, requestId, outcome);
+    }
+    appendClosed(closing) {
+        // The prompt was kept for a re-post only; a closed request is never re-posted,
+        // and the history must not grow by every prompt (issue text included).
+        const { prompt: _prompt, isPromptTakenIn: _isPromptTakenIn, ...record } = closing;
+        if (!this.history.append(record)) {
+            console.warn(`[requests] could not append ${record.id} to ${this.history.filePath}; it is closed in memory only`);
+        }
+        this.indexClosed(record);
+        if (record.alertRef !== undefined) {
+            this.queueAlertRelease(record.id, { conversationKey: record.conversationKey, alertRef: record.alertRef });
+        }
+    }
+    /**
+     * Record a closed request's alert as still to release (synchronously, so it
+     * rides the close's own save), then release it.
+     */
+    queueAlertRelease(requestId, alert) {
+        this.store.addUnreleasedRequestAlert(requestId, alert);
+        void this.releaseAlertOf(requestId, alert);
+    }
+    /** Release an alert; it leaves the unreleased list only once the release succeeded. */
+    async releaseAlertOf(requestId, alert) {
+        if (!this.releaseAlert || this.alertReleasesInFlight.has(requestId))
+            return;
+        this.alertReleasesInFlight.add(requestId);
+        try {
+            await this.releaseAlert(alert);
+            this.store.removeUnreleasedRequestAlert(requestId);
+        }
+        catch (e) {
+            console.warn(`[requests] releasing the alert of ${requestId} failed; retried at the next start:`, e instanceof Error ? e.message : e);
+        }
+        finally {
+            this.alertReleasesInFlight.delete(requestId);
+        }
+    }
+    /**
+     * @description Store the alert a request now holds, DURABLY (flushed): a crash
+     * that lost it would leave the alert pinned forever. Resolves `false` when the
+     * request closed meanwhile — its close found no alert, so it is released here.
+     */
+    async recordAlert(key, requestId, alertRef) {
+        this.assertLoaded();
+        const stored = await this.updateOpenRequest(requestId, { alertRef });
+        if (stored) {
+            await this.store.flush();
+            return true;
+        }
+        this.queueAlertRelease(requestId, { conversationKey: (0, sessionKey_1.keyToString)(key), alertRef });
+        return false;
+    }
+    /** Remember a closed request by id, forgetting the oldest beyond the window. */
+    indexClosed(record) {
+        this.closedById.delete(record.id);
+        this.closedById.set(record.id, record);
+        while (this.closedById.size > this.closedIndexMaxSize) {
+            const oldestId = this.closedById.keys().next().value;
+            if (oldestId === undefined)
+                break;
+            this.closedById.delete(oldestId);
+        }
+    }
+    /**
+     * @description Open a new request for `key`'s conversation. The open request of
+     * the same GROUP (same conversation, same requester — `getRequestGroupKey`), if
+     * any, is closed as `superseded` first, in the same atomic step — the latest
+     * message of a requester is the one that matters, and the new request names it
+     * (and what it had replaced in turn) in `supersededRequestIds`, so the agent
+     * answers only what the new one adds. Another requester's open request in the conversation is
+     * untouched. A request WITHOUT a requester (persisted before requesters
+     * existed, or raised by an origin that names none) keeps the old rule: the
+     * conversation's next request supersedes it whoever raised that one — else it
+     * would linger, woken again and again, with nothing left that could close it.
+     * Resolves only once the new request is DURABLY saved: its id is
+     * about to reach an agent, and an id the agent was told about but a crash lost
+     * would make its answer refused as unknown — a dropped result.
+     */
+    async createRequest(key, origin, options = {}) {
+        this.assertLoaded();
+        const createdAt = this.now();
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        const group = (0, requestGroup_1.getRequestGroupKey)(key, origin);
+        const id = this.createRequestId();
+        const requesterlessGroup = { conversation: key, requester: requestGroup_1.emptyRequester };
+        const requesterless = group.requester === requestGroup_1.emptyRequester ? undefined : this.store.getOpenRequest(requesterlessGroup);
+        let request = null;
+        const settled = [];
+        const closeSuperseded = (current) => {
+            const record = { ...current, conversationKey, closedAt: createdAt, closeReason: 'superseded', supersededBy: id };
+            this.appendClosed(record);
+            const outcome = this.getCloseOutcome(record);
+            if (outcome)
+                settled.push({ requestId: record.id, outcome });
+        };
+        await this.store.updateOpenRequest(group, (current) => {
+            const supersededRequestIds = [requesterless, current]
+                .flatMap((replaced) => (replaced ? [...(replaced.supersededRequestIds ?? []), replaced.id] : []))
+                .slice(-exports.supersededRequestIdsMaxLength);
+            const prompt = options.createPrompt?.(id, supersededRequestIds);
+            if (prompt !== undefined && prompt.length > exports.requestPromptMaxLength) {
+                console.warn(`[requests] ${id}: prompt of ${prompt.length} chars not kept (over ${exports.requestPromptMaxLength}); a wake-up sends a reminder instead`);
+            }
+            const created = {
+                id,
+                origin,
+                createdAt,
+                progressAnswerCount: 0,
+                silentTurnCount: 0,
+                wakeCount: 0,
+                isWakeStopped: false,
+                ...(prompt !== undefined && prompt.length <= exports.requestPromptMaxLength ? { prompt } : {}),
+                ...(supersededRequestIds.length > 0 ? { supersededRequestIds } : {}),
+            };
+            if (current)
+                closeSuperseded(current);
+            request = created;
+            return created;
+        });
+        if (!request)
+            throw new Error(`[requests] ${id}: the store did not run the create`);
+        if (requesterless) {
+            // Its own group, so a separate step AFTER the create: a crash between the two
+            // leaves it open for the conversation's next request, never a lost new one.
+            await this.store.updateOpenRequest(requesterlessGroup, (current) => {
+                if (current?.id !== requesterless.id)
+                    return current;
+                closeSuperseded(current);
+                return undefined;
+            });
+        }
+        await this.store.flush();
+        this.notePromptSettled(key, settled);
+        this.onRequestCreated?.(key, request);
+        return request;
+    }
+    /** @description A request by id, open or closed, or `null` for an unknown id. */
+    getRequest(id) {
+        this.assertLoaded();
+        const open = this.getOpenEntryById(id);
+        if (open)
+            return { isOpen: true, conversationKey: (0, sessionKey_1.keyToString)(open.key), request: open.request };
+        const closed = this.closedById.get(id);
+        return closed ? { isOpen: false, conversationKey: closed.conversationKey, request: closed } : null;
+    }
+    /** @description The open request `id`, with its conversation, or `undefined` when `id` is not open. */
+    getOpenRequestById(id) {
+        this.assertLoaded();
+        return this.getOpenEntryById(id);
+    }
+    /**
+     * @description The open requests of `key`'s conversation, oldest first — one per
+     * requester at most (see `requestGroup.ts`).
+     */
+    listOpenRequestsOf(key) {
+        this.assertLoaded();
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        return this.getOpenEntries()
+            .filter((entry) => (0, sessionKey_1.keyToString)(entry.key) === conversationKey)
+            .map((entry) => entry.request);
+    }
+    /**
+     * @description The NEWEST open request of `key`'s conversation, or `undefined`.
+     * A conversation may hold one open request per requester; a caller that must
+     * act on all of them uses {@link listOpenRequestsOf}.
+     */
+    getNewestOpenRequest(key) {
+        this.assertLoaded();
+        return this.listOpenRequestsOf(key).at(-1);
+    }
+    /** @description Every open request with its conversation, oldest first. */
+    listOpenRequests() {
+        this.assertLoaded();
+        return this.getOpenEntries();
+    }
+    /**
+     * @description Change the answer and wake-up bookkeeping of an open request.
+     * Resolves the updated request, or `null` when `id` is not open (closed or
+     * superseded in the meantime — the update is then dropped, never applied to
+     * its successor).
+     */
+    async updateOpenRequest(id, update) {
+        this.assertLoaded();
+        const entry = this.getOpenEntryById(id);
+        if (!entry)
+            return null;
+        let updated = null;
+        let isTakenInNow = false;
+        await this.store.updateOpenRequest(entry.group, (current) => {
+            if (current?.id !== id)
+                return current;
+            const next = { ...current, ...(typeof update === 'function' ? update(current) : update) };
+            isTakenInNow = current.isPromptTakenIn !== true && next.isPromptTakenIn === true;
+            updated = next;
+            return next;
+        });
+        if (isTakenInNow)
+            this.notePromptSettled(entry.key, [{ requestId: id, outcome: 'takenIn' }]);
+        return updated;
+    }
+    /**
+     * @description Close an open request. Resolves the closed record, or `null` when
+     * `id` is not open (an already closed request is never closed twice).
+     */
+    async closeRequest(id, reason) {
+        this.assertLoaded();
+        const entry = this.getOpenEntryById(id);
+        if (!entry)
+            return null;
+        const conversationKey = (0, sessionKey_1.keyToString)(entry.key);
+        let closed = null;
+        await this.store.updateOpenRequest(entry.group, (current) => {
+            if (current?.id !== id)
+                return current;
+            const record = { ...current, conversationKey, closedAt: this.now(), closeReason: reason };
+            this.appendClosed(record);
+            closed = record;
+            return undefined;
+        });
+        const outcome = closed ? this.getCloseOutcome(closed) : null;
+        if (outcome)
+            this.notePromptSettled(entry.key, [{ requestId: id, outcome }]);
+        return closed;
+    }
+}
+exports.RequestLedger = RequestLedger;
+//# sourceMappingURL=requestLedger.js.map

package/dist/requests/requestLedger.js.map

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

package/dist/requests/sessionTurnProbe.d.ts

@@ -0,0 +1,52 @@
+import type { SessionKey } from '../sessionKey';
+import type { AgentAdapter } from '../types';
+import type { SessionTurnProbe } from './wakeUpRules';
+/**
+ * @description How the wake-up engine sees a conversation's session right now
+ * (request/answer core S4), built from the adapter and the bot's per-thread
+ * state. Kept out of `bot.ts` so each "not a turn end" rule is testable.
+ *
+ * What holds a turn open (a wake-up must not fire, a watched turn has not ended):
+ *  - a pending native question — the bot's own pending state, the question pin,
+ *    or the adapter reading a TUI selector / login code prompt off the pane (the
+ *    pin exists only when pinning succeeded, so the adapter is the authority);
+ *  - a running compaction;
+ *  - an API-error retry or usage-limit wait still ARMED — a fired record stays
+ *    for its grace window, and counting it would hold the turn until the next
+ *    user message;
+ *  - a wedged-turn recovery in flight: it restarts the session and replays the
+ *    original prompt (which carries the request header), so a reminder on top
+ *    would be a second recovery of the same turn;
+ *  - an API-error retry or limit resume being KICKED: from the moment its timer
+ *    fired until its "continue" nudge was forwarded the retry is no longer armed,
+ *    yet the idle the error left behind is not a turn end either;
+ *  - a session START under way: a request's first post is starting the session it
+ *    will run in, so nothing has gone quiet — without this the sweep reads the
+ *    request as one nobody works on and wakes it (or raises an alert) once the
+ *    backstop window is shorter than the start.
+ *
+ * A session still starting has not taken in what was forwarded to it either: the
+ * prompt waits in the startup buffer, while a backend may already report itself
+ * active with nothing unread.
+ */
+/**
+ * @name SessionTurnProbeDeps
+ * @description The bot state the probe reads, per serialized conversation key.
+ * `getApiRetryTimer` returns `undefined` when there is no record, `null` when the
+ * record's timer already fired, the timer while it is armed.
+ */
+export interface SessionTurnProbeDeps {
+    getAdapter: (key: SessionKey) => Pick<AgentAdapter, 'checkIsActive' | 'checkIsBusy' | 'checkHasUnconsumedInput' | 'isQuestionPending' | 'isLoginPastePending'>;
+    checkHasPendingQuestion: (keyString: string) => boolean;
+    checkHasQuestionPin: (keyString: string) => boolean;
+    checkIsCompacting: (keyString: string) => boolean;
+    getApiRetryTimer: (keyString: string) => NodeJS.Timeout | null | undefined;
+    checkIsWedgeRecoveryInFlight: (keyString: string) => boolean;
+    checkIsRetryKickInFlight: (keyString: string) => boolean;
+    /** The session is in its startup window: prompts forwarded now are buffered, not written. */
+    checkIsSessionStarting: (keyString: string) => boolean;
+    serializeKey: (key: SessionKey) => string;
+}
+/** @description Build the probe the wake-up engine polls. */
+export declare function createSessionTurnProbe(deps: SessionTurnProbeDeps): (key: SessionKey) => SessionTurnProbe;
+//# sourceMappingURL=sessionTurnProbe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTurnProbe.d.ts","sourceRoot":"","sources":["../../src/requests/sessionTurnProbe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CACnC,YAAY,EACZ,eAAe,GAAG,aAAa,GAAG,yBAAyB,GAAG,mBAAmB,GAAG,qBAAqB,CAC1G,CAAC;IACF,uBAAuB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3E,4BAA4B,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7D,wBAAwB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,6FAA6F;IAC7F,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,CAAC;CAC3C;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,gBAAgB,CAwBxG"}

package/dist/requests/sessionTurnProbe.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionTurnProbe = createSessionTurnProbe;
+/** @description Build the probe the wake-up engine polls. */
+function createSessionTurnProbe(deps) {
+    return (key) => {
+        const keyString = deps.serializeKey(key);
+        const adapter = deps.getAdapter(key);
+        const isActive = adapter.checkIsActive(key);
+        const isTurnEndBlocked = deps.checkHasPendingQuestion(keyString) ||
+            deps.checkHasQuestionPin(keyString) ||
+            (adapter.isQuestionPending?.(key) ?? false) ||
+            (adapter.isLoginPastePending?.(key) ?? false) ||
+            deps.checkIsCompacting(keyString) ||
+            Boolean(deps.getApiRetryTimer(keyString)) ||
+            deps.checkIsWedgeRecoveryInFlight(keyString) ||
+            deps.checkIsRetryKickInFlight(keyString) ||
+            deps.checkIsSessionStarting(keyString);
+        return {
+            isActive,
+            isBusy: isActive && (adapter.checkIsBusy?.(key) ?? false),
+            hasUnconsumedInput: deps.checkIsSessionStarting(keyString)
+                ? true
+                : adapter.checkHasUnconsumedInput ? adapter.checkHasUnconsumedInput(key) : null,
+            isTurnEndBlocked,
+        };
+    };
+}
+//# sourceMappingURL=sessionTurnProbe.js.map

package/dist/requests/sessionTurnProbe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTurnProbe.js","sourceRoot":"","sources":["../../src/requests/sessionTurnProbe.ts"],"names":[],"mappings":";;AAwDA,wDAwBC;AAzBD,6DAA6D;AAC7D,SAAgB,sBAAsB,CAAC,IAA0B;IAC/D,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,gBAAgB,GACpB,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC;YACvC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC;YACnC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;YAC3C,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;YAC7C,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,4BAA4B,CAAC,SAAS,CAAC;YAC5C,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;YACxC,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO;YACL,QAAQ;YACR,MAAM,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;YACzD,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC;gBACxD,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;YACjF,gBAAgB;SACjB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}