crewly 1.20.306 → 1.20.308

package/dist/backend/backend/src/services/board/board-activity.tracker.js

@@ -0,0 +1,346 @@
+/**
+ * Live activity per agent (crewly#1247): the current activity, the last
+ * meaningful action and a rolling timeline, fed by hook events, browser
+ * actions, chat replies and owner waits. In memory only: a restart starts the
+ * timeline over (the agents restart with it).
+ *
+ * Event-driven: `record*` do a few map operations and tell the listeners; the
+ * push scheduler decides when to send. Nothing here reads files or the
+ * network.
+ *
+ * @module services/board/board-activity.tracker
+ */
+import { BOARD_CONSTANTS } from '../../constants.js';
+import { normalizeBrowserAction, normalizeMessage, normalizeOwnerWait, normalizeToolUse, THINKING, } from './board-activity.normalizer.js';
+import { StepStream } from './canvas/canvas-step.stream.js';
+import { stepOfBrowserAction, stepOfMessage, stepOfOwnerWait, stepOfTool } from './canvas/canvas-step.normalizer.js';
+const C = BOARD_CONSTANTS;
+/**
+ * Per-session board activity.
+ */
+export class BoardActivityTracker {
+    static instance = null;
+    sessions = new Map();
+    listeners = new Set();
+    /** Project roots by session, for relative paths */
+    rootsOf = () => [];
+    /** The canvas step stream: the same events, one line per tool call with its duration */
+    steps = new StepStream();
+    /** @returns The process-wide tracker */
+    static getInstance() {
+        if (!BoardActivityTracker.instance)
+            BoardActivityTracker.instance = new BoardActivityTracker();
+        return BoardActivityTracker.instance;
+    }
+    /** Drop the process-wide tracker (tests). */
+    static resetInstance() {
+        BoardActivityTracker.instance = null;
+    }
+    /**
+     * Where an agent's project roots come from.
+     *
+     * @param fn - Session -> project roots
+     */
+    setRootsResolver(fn) {
+        this.rootsOf = fn;
+    }
+    /**
+     * Subscribe to changes.
+     *
+     * @param listener - Called with the session whose row may have changed
+     * @returns Unsubscribe
+     */
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(session) {
+        for (const l of this.listeners) {
+            try {
+                l(session);
+            }
+            catch {
+                // a listener must never break a hook
+            }
+        }
+    }
+    get(session) {
+        let s = this.sessions.get(session);
+        if (!s) {
+            s = { open: new Map(), current: null, last: null, ownerWait: null, timeline: [], unsent: [], seq: 0, waitStep: null };
+            this.sessions.set(session, s);
+        }
+        return s;
+    }
+    /**
+     * A hook event arrived. PreToolUse starts an activity; PostToolUse ends
+     * it; UserPromptSubmit / Stop / SessionStart reset the turn; a permission
+     * prompt or question is a wait on the owner.
+     *
+     * @param session - Agent session
+     * @param event - Hook event name
+     * @param info - Tool details (PreToolUse / PostToolUse) and the notification type
+     * @param now - Clock (tests)
+     */
+    recordHook(session, event, info = {}, now = Date.now()) {
+        const s = this.get(session);
+        switch (event) {
+            case 'PreToolUse': {
+                if (!info.toolName)
+                    return;
+                const roots = this.safeRoots(session);
+                const activity = normalizeToolUse(info.toolName, info.toolInput ?? {}, { roots });
+                s.open.set(info.toolUseId ?? `anon-${(s.seq += 1)}`, now);
+                this.endWaitStep(session, s, now);
+                s.ownerWait = null;
+                this.steps.start(session, stepOfTool(info.toolName, info.toolInput ?? {}, { roots }), { ...(info.toolUseId ? { id: info.toolUseId } : {}) }, now);
+                this.show(session, s, activity, now);
+                return;
+            }
+            case 'PostToolUse': {
+                if (info.toolUseId)
+                    s.open.delete(info.toolUseId);
+                else if (s.open.size > 0)
+                    s.open.delete(s.open.keys().next().value);
+                if (s.current)
+                    s.current.lastEventAt = now;
+                this.endWaitStep(session, s, now);
+                s.ownerWait = null;
+                this.steps.finish(session, info.toolUseId, 'done', now);
+                return;
+            }
+            case 'UserPromptSubmit':
+            case 'SessionStart':
+                s.open.clear();
+                this.endWaitStep(session, s, now);
+                s.ownerWait = null;
+                this.steps.closeAll(session, now);
+                s.current = { activity: THINKING, since: now, lastEventAt: now };
+                this.emit(session);
+                return;
+            case 'Stop':
+                s.open.clear();
+                this.endWaitStep(session, s, now);
+                s.ownerWait = null;
+                this.steps.closeAll(session, now);
+                s.current = null;
+                this.emit(session);
+                return;
+            case 'Notification':
+            case 'PermissionRequest':
+                if (event === 'PermissionRequest' || info.notificationType === 'permission_prompt') {
+                    this.setOwnerWait(session, 'permission to continue', now);
+                }
+                else if (info.notificationType === 'elicitation_dialog') {
+                    this.setOwnerWait(session, 'an answer to its question', now);
+                }
+                return;
+            default:
+                return;
+        }
+    }
+    /**
+     * An agent action in Chrome.
+     *
+     * @param session - Agent session
+     * @param tool - Extension tool name
+     * @param url - Page URL, if known
+     * @param now - Clock (tests)
+     */
+    recordBrowser(session, tool, url, now = Date.now()) {
+        const s = this.get(session);
+        this.steps.instant(session, stepOfBrowserAction(tool, url), now);
+        this.show(session, s, normalizeBrowserAction(tool, url), now);
+    }
+    /**
+     * An agent posted to a channel or the owner chat.
+     *
+     * @param session - Agent session
+     * @param channel - Channel or chat name
+     * @param now - Clock (tests)
+     */
+    recordMessage(session, channel, now = Date.now()) {
+        const s = this.get(session);
+        this.steps.instant(session, stepOfMessage(channel), now);
+        this.show(session, s, normalizeMessage(channel), now);
+    }
+    /**
+     * An agent waits on the owner.
+     *
+     * @param session - Agent session
+     * @param what - Short plain-words description
+     * @param now - Clock (tests)
+     */
+    setOwnerWait(session, what, now = Date.now()) {
+        const s = this.get(session);
+        if (s.ownerWait)
+            return;
+        const activity = normalizeOwnerWait(what);
+        s.ownerWait = { activity, since: now };
+        s.waitStep = this.steps.start(session, stepOfOwnerWait(what), {}, now);
+        this.pushTimeline(s, session, activity, now);
+        this.emit(session);
+    }
+    /**
+     * The wait is over.
+     *
+     * @param session - Agent session
+     */
+    clearOwnerWait(session) {
+        const s = this.sessions.get(session);
+        if (!s?.ownerWait)
+            return;
+        this.endWaitStep(session, s, Date.now());
+        s.ownerWait = null;
+        this.emit(session);
+    }
+    /** The wait on the owner is over: its canvas step ends. */
+    endWaitStep(session, s, now) {
+        if (!s.waitStep)
+            return;
+        this.steps.finish(session, s.waitStep, 'done', now);
+        s.waitStep = null;
+    }
+    /** Make `activity` current and the last action; notify when the row changed. */
+    show(session, s, activity, now) {
+        const prev = s.current;
+        const same = prev !== null && prev.activity.type === activity.type && prev.activity.detail === activity.detail;
+        s.current = { activity, since: same && prev ? prev.since : now, lastEventAt: now };
+        if (activity.type !== 'thinking') {
+            const changedText = s.last?.text !== activity.text;
+            s.last = { text: activity.text, at: now };
+            this.pushTimeline(s, session, activity, now);
+            if (!same || changedText)
+                this.emit(session);
+        }
+        else if (!same) {
+            this.emit(session);
+        }
+    }
+    pushTimeline(s, session, activity, now) {
+        const tail = s.timeline[s.timeline.length - 1];
+        // The same line twice within 10 s is one event (a tool called in a loop)
+        if (tail && tail.text === activity.text && now - Date.parse(tail.at) < 10_000)
+            return;
+        const event = { session, at: new Date(now).toISOString(), type: activity.type, text: activity.text };
+        s.timeline.push(event);
+        s.unsent.push(event);
+        if (s.timeline.length > C.TIMELINE_MAX_EVENTS)
+            s.timeline.splice(0, s.timeline.length - C.TIMELINE_MAX_EVENTS);
+        if (s.unsent.length > C.TIMELINE_MAX_EVENTS)
+            s.unsent.splice(0, s.unsent.length - C.TIMELINE_MAX_EVENTS);
+    }
+    safeRoots(session) {
+        try {
+            return this.rootsOf(session);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * What the session shows now. While a tool runs it is that tool; for
+     * {@link BOARD_CONSTANTS.ACTIVITY_LINGER_MS} after it, the same; then
+     * "thinking" (when `working`), else nothing.
+     *
+     * @param session - Agent session
+     * @param working - The runtime says the agent is in a turn
+     * @param now - Clock (tests)
+     * @returns Activity and last action
+     */
+    live(session, working, now = Date.now()) {
+        const s = this.sessions.get(session);
+        if (!s)
+            return { activity: working ? { type: 'thinking', detail: THINKING.detail, since: new Date(now).toISOString() } : null, lastAction: null };
+        const lastAction = s.last ? { text: s.last.text, at: new Date(s.last.at).toISOString() } : null;
+        if (s.ownerWait) {
+            return { activity: { type: s.ownerWait.activity.type, detail: s.ownerWait.activity.detail, since: new Date(s.ownerWait.since).toISOString() }, lastAction };
+        }
+        // A lost PostToolUse must not pin a tool forever
+        for (const [id, at] of s.open)
+            if (now - at > C.OPEN_TOOL_MAX_MS)
+                s.open.delete(id);
+        const cur = s.current;
+        if (!working && s.open.size === 0)
+            return { activity: null, lastAction };
+        if (cur && (s.open.size > 0 || now - cur.lastEventAt <= C.ACTIVITY_LINGER_MS || cur.activity.type === 'thinking')) {
+            return { activity: { type: cur.activity.type, detail: cur.activity.detail, since: new Date(cur.since).toISOString() }, lastAction };
+        }
+        if (working) {
+            const since = cur ? cur.lastEventAt + C.ACTIVITY_LINGER_MS : now;
+            return { activity: { type: 'thinking', detail: THINKING.detail, since: new Date(Math.min(since, now)).toISOString() }, lastAction };
+        }
+        return { activity: null, lastAction };
+    }
+    /**
+     * Timeline events not sent yet. Call {@link ackUnsent} once Cloud took them;
+     * until then they stay queued (capped), so a failed push loses nothing.
+     *
+     * @param sessions - Only these sessions (all when omitted)
+     * @returns Events, oldest first, at most {@link BOARD_CONSTANTS.DELTA_TIMELINE_MAX} per session
+     */
+    peekUnsent(sessions) {
+        const out = [];
+        const keys = sessions ? [...sessions] : [...this.sessions.keys()];
+        for (const key of keys) {
+            const s = this.sessions.get(key);
+            if (!s || s.unsent.length === 0)
+                continue;
+            out.push(...s.unsent.slice(-C.DELTA_TIMELINE_MAX));
+        }
+        return out.sort((a, b) => Date.parse(a.at) - Date.parse(b.at));
+    }
+    /**
+     * Mark events as sent (everything unsent up to the newest of them is
+     * dropped, including older ones cut by the per-delta limit).
+     *
+     * @param events - Events returned by {@link peekUnsent} that Cloud took
+     */
+    ackUnsent(events) {
+        const newest = new Map();
+        for (const e of events)
+            newest.set(e.session, Math.max(newest.get(e.session) ?? 0, Date.parse(e.at)));
+        for (const [session, at] of newest) {
+            const s = this.sessions.get(session);
+            if (s)
+                s.unsent = s.unsent.filter((e) => Date.parse(e.at) > at);
+        }
+    }
+    /** Sessions with timeline events not yet sent. */
+    sessionsWithUnsent() {
+        return [...this.sessions.entries()].filter(([, s]) => s.unsent.length > 0).map(([k]) => k);
+    }
+    /**
+     * A session's recent timeline (24 h, newest last).
+     *
+     * @param session - Agent session
+     * @param now - Clock (tests)
+     * @returns Events
+     */
+    timeline(session, now = Date.now()) {
+        const s = this.sessions.get(session);
+        if (!s)
+            return [];
+        const cutoff = now - C.TIMELINE_MAX_AGE_MS;
+        s.timeline = s.timeline.filter((e) => Date.parse(e.at) >= cutoff);
+        return [...s.timeline];
+    }
+    /**
+     * Forget a session (it was deleted).
+     *
+     * @param session - Agent session
+     */
+    forget(session) {
+        this.sessions.delete(session);
+        this.steps.forget(session);
+    }
+}
+/**
+ * The process-wide tracker.
+ *
+ * @returns The tracker
+ */
+export function getBoardActivity() {
+    return BoardActivityTracker.getInstance();
+}
+//# sourceMappingURL=board-activity.tracker.js.map

package/dist/backend/backend/src/services/board/board-activity.tracker.js.map

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

package/dist/backend/backend/src/services/board/board-outcome-phrases.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Result phrases for the "Done today" strip (crewly#1247): a finished
+ * ticket or WorkItem is described by what it produced ("post published"),
+ * and equal results are counted ("2 posts published"). Deterministic keyword
+ * rules over the title and kind; no model call.
+ *
+ * Pure (no I/O).
+ *
+ * @module services/board/board-outcome-phrases
+ */
+/** One kind of result. */
+interface ResultRule {
+    /** Matches the title (and kind label) */
+    pattern: RegExp;
+    one: string;
+    many: string;
+}
+/**
+ * The rule describing a finished item.
+ *
+ * @param title - Item title
+ * @param kind - Ticket kind (`issue`, `feature`, ...), when known
+ * @returns A rule (a generic one when no keyword matches)
+ */
+export declare function ruleFor(title: string, kind?: string): ResultRule;
+/**
+ * The result of one finished item, in singular ("post published").
+ *
+ * @param title - Item title
+ * @param kind - Ticket kind, when known
+ * @returns Result phrase
+ */
+export declare function resultOf(title: string, kind?: string): string;
+/**
+ * Count equal results: ["post published","post published","bug fixed"] ->
+ * ["2 posts published", "1 bug fixed"], most frequent first.
+ *
+ * @param results - Singular result phrases
+ * @returns Summary phrases (at most {@link BOARD_CONSTANTS.MAX_SUMMARY_PHRASES})
+ */
+export declare function summarizeResults(results: readonly string[]): string[];
+export {};
+//# sourceMappingURL=board-outcome-phrases.d.ts.map

package/dist/backend/backend/src/services/board/board-outcome-phrases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-outcome-phrases.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/board/board-outcome-phrases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,0BAA0B;AAC1B,UAAU,UAAU;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAyBD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAIhE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CASrE"}

package/dist/backend/backend/src/services/board/board-outcome-phrases.js

@@ -0,0 +1,76 @@
+/**
+ * Result phrases for the "Done today" strip (crewly#1247): a finished
+ * ticket or WorkItem is described by what it produced ("post published"),
+ * and equal results are counted ("2 posts published"). Deterministic keyword
+ * rules over the title and kind; no model call.
+ *
+ * Pure (no I/O).
+ *
+ * @module services/board/board-outcome-phrases
+ */
+import { BOARD_CONSTANTS } from '../../constants.js';
+const RULES = [
+    { pattern: /\b(?:posts?|tweets?|threads?|linkedin|newsletter|publish(?:ed|ing)?|announce(?:ment)?s?|social)\b/i, one: 'post published', many: 'posts published' },
+    { pattern: /\b(?:customers?|clients?|support|inquir(?:y|ies)|repl(?:y|ies|ied)|dms?)\b/i, one: 'customer answered', many: 'customers answered' },
+    { pattern: /\b(?:bugs?|fix(?:es|ed)?|hotfix|regression|crash|broken)\b/i, one: 'bug fixed', many: 'bugs fixed' },
+    { pattern: /\b(?:releases?|deploy(?:ed|ment)?|ship(?:ped)?|rollout|launch)\b/i, one: 'release shipped', many: 'releases shipped' },
+    { pattern: /\b(?:pull request|pr #?\d+|merge[ds]?)\b/i, one: 'change merged', many: 'changes merged' },
+    { pattern: /\b(?:reports?|summary|digest|analysis|research|audit|review(?:ed)?|survey)\b/i, one: 'report delivered', many: 'reports delivered' },
+    { pattern: /\b(?:videos?|designs?|images?|banners?|graphics?|canva|thumbnails?|logo)\b/i, one: 'design created', many: 'designs created' },
+    { pattern: /\b(?:docs?|documents?|articles?|blog|write-?ups?|specs?|guides?|sop|copy|draft)\b/i, one: 'document written', many: 'documents written' },
+    { pattern: /\b(?:tests?|ci|lint|refactor|cleanup|chore|migrat(?:e|ion))\b/i, one: 'chore finished', many: 'chores finished' },
+    { pattern: /\b(?:features?|implement(?:ed)?|add(?:ed)?|build|built|page|app)\b/i, one: 'feature built', many: 'features built' },
+];
+/** Kind of a finished item, from its ticket kind when it has one. */
+const KIND_FALLBACK = {
+    issue: { pattern: /./, one: 'issue resolved', many: 'issues resolved' },
+    feature: { pattern: /./, one: 'feature built', many: 'features built' },
+    idea: { pattern: /./, one: 'idea explored', many: 'ideas explored' },
+    question: { pattern: /./, one: 'question answered', many: 'questions answered' },
+};
+const GENERIC = { pattern: /./, one: 'task done', many: 'tasks done' };
+/**
+ * The rule describing a finished item.
+ *
+ * @param title - Item title
+ * @param kind - Ticket kind (`issue`, `feature`, ...), when known
+ * @returns A rule (a generic one when no keyword matches)
+ */
+export function ruleFor(title, kind) {
+    for (const rule of RULES)
+        if (rule.pattern.test(title))
+            return rule;
+    if (kind && KIND_FALLBACK[kind])
+        return KIND_FALLBACK[kind];
+    return GENERIC;
+}
+/**
+ * The result of one finished item, in singular ("post published").
+ *
+ * @param title - Item title
+ * @param kind - Ticket kind, when known
+ * @returns Result phrase
+ */
+export function resultOf(title, kind) {
+    return ruleFor(title, kind).one;
+}
+/**
+ * Count equal results: ["post published","post published","bug fixed"] ->
+ * ["2 posts published", "1 bug fixed"], most frequent first.
+ *
+ * @param results - Singular result phrases
+ * @returns Summary phrases (at most {@link BOARD_CONSTANTS.MAX_SUMMARY_PHRASES})
+ */
+export function summarizeResults(results) {
+    const counts = new Map();
+    for (const r of results)
+        counts.set(r, (counts.get(r) ?? 0) + 1);
+    const byOne = new Map();
+    for (const rule of [...RULES, ...Object.values(KIND_FALLBACK), GENERIC])
+        byOne.set(rule.one, rule);
+    return [...counts.entries()]
+        .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+        .slice(0, BOARD_CONSTANTS.MAX_SUMMARY_PHRASES)
+        .map(([one, n]) => `${n} ${n === 1 ? one : (byOne.get(one)?.many ?? one)}`);
+}
+//# sourceMappingURL=board-outcome-phrases.js.map

package/dist/backend/backend/src/services/board/board-outcome-phrases.js.map

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

package/dist/backend/backend/src/services/board/board-push.service.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Pushes the owner board to Crewly Cloud (crewly#1247).
+ *
+ * - a full snapshot every 60 s (Cloud may ask for another cadence);
+ * - a delta (only the agent rows that changed, plus new timeline events and
+ *   canvas steps) within {@link BOARD_CONSTANTS.DELTA_DELAY_MS} of an activity
+ *   change, or within {@link CANVAS_CONSTANTS.LIVE_DELTA_DELAY_MS} while Cloud
+ *   says someone is watching the canvas (`live: true` / `viewers > 0` in its
+ *   answer, believed for {@link CANVAS_CONSTANTS.LIVE_TTL_MS});
+ * - gzip bodies, exponential backoff on failure, an hour's pause when Cloud
+ *   does not take board pushes (not deployed / refusing);
+ * - nothing is sent when the machine is not signed in to Cloud, or when
+ *   `CREWLY_BOARD_PUSH=0`.
+ *
+ * Event-driven: a change only marks a session dirty and arms one timer; the
+ * delta is built from the builder's cache and the live tracker, never from a
+ * disk scan.
+ *
+ * @module services/board/board-push.service
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { BoardActivityTracker } from './board-activity.tracker.js';
+import type { BoardSnapshotBuilder } from './board-snapshot.builder.js';
+import type { BoardSnapshot } from './board.types.js';
+/** The Cloud session (CloudClientService). */
+export interface BoardCloudSession {
+    getToken(): string | null;
+    getCloudUrl(): string | null;
+    tryRefreshToken?(): Promise<boolean>;
+}
+/** Constructor dependencies. */
+export interface BoardPushDeps {
+    builder: BoardSnapshotBuilder;
+    tracker: BoardActivityTracker;
+    cloud: BoardCloudSession;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: (input: string, init: RequestInit) => Promise<Response>;
+    now?: () => number;
+    setTimeout?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clearTimeout?: (handle: ReturnType<typeof setTimeout>) => void;
+    logger?: ComponentLogger;
+}
+/** What one push did. */
+export type BoardPushOutcome = 'sent' | 'nothing' | 'skipped' | 'paused' | 'failed';
+/**
+ * Whether the board push is switched off.
+ *
+ * @param env - Environment
+ * @returns True for `CREWLY_BOARD_PUSH=0` (also `false` / `off`)
+ */
+export declare function isBoardPushDisabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Shrink a snapshot until its JSON fits the body limit: the longest list
+ * loses its tail first.
+ *
+ * @param snapshot - Snapshot (mutated)
+ * @returns The same snapshot
+ */
+export declare function fitSnapshot(snapshot: BoardSnapshot): BoardSnapshot;
+/** Pushes snapshots and deltas. */
+export declare class BoardPushService {
+    private readonly deps;
+    private readonly logger;
+    private readonly fetchImpl;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    private started;
+    private fullTimer;
+    private deltaTimer;
+    private unsubscribe;
+    private readonly dirty;
+    /** Rows Cloud has, as JSON, by session */
+    private readonly lastSent;
+    private lastToken;
+    private fullOk;
+    private fullAfterMs;
+    private failures;
+    private pausedUntil;
+    private pauseLogged;
+    /** Cloud said viewers are watching until this time (epoch ms) */
+    private liveUntil;
+    private inFlight;
+    constructor(deps: BoardPushDeps);
+    /**
+     * Whether Cloud recently said someone is watching the canvas.
+     *
+     * @returns True while the live answer is believed
+     */
+    isLive(): boolean;
+    /**
+     * Treat the canvas as watched for a while (an owner action just arrived, so
+     * someone is there).
+     */
+    noteViewer(): void;
+    /** Whether the push is switched off in the environment. */
+    get disabled(): boolean;
+    /** Start pushing. Idempotent; a no-op when switched off. Never throws. */
+    start(): void;
+    /** Stop timers and the subscription. */
+    stop(): void;
+    /**
+     * A session's row may have changed: send a delta soon.
+     *
+     * @param session - Agent session
+     */
+    markDirty(session: string): void;
+    private scheduleFull;
+    private nextFullDelay;
+    /** The Cloud endpoint and token, or null when the machine is not signed in or a pause is on. */
+    private target;
+    /**
+     * Build and send the full snapshot, then any timeline events that are
+     * waiting. Serialised with deltas. Never throws.
+     *
+     * @returns What happened
+     */
+    pushFull(): Promise<BoardPushOutcome>;
+    private doFull;
+    /**
+     * Send a delta for the sessions marked dirty. Serialised with full pushes.
+     * Never throws.
+     *
+     * @returns What happened
+     */
+    flushDelta(): Promise<BoardPushOutcome>;
+    private doDelta;
+    /** Cloud's answer says whether anyone is watching (`live: true` or `viewers > 0`, at the top or under `next`). */
+    private noteLiveAnswer;
+    private post;
+}
+//# sourceMappingURL=board-push.service.d.ts.map

package/dist/backend/backend/src/services/board/board-push.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-push.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/board/board-push.service.ts"],"names":[],"mappings":"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"}