@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/dashboard/bridge-sessions.d.ts

@@ -0,0 +1,25 @@
+import type { AgentMeta } from '../store/index.js';
+import type { BridgeSession } from './bridge-endpoints.js';
+/** How far back a cloud agent's session is still served: the session window, shared with its cloud state (#1668). */
+export declare const BRIDGE_SESSION_WINDOW_MS: number;
+/**
+ * Which cloud sessions the extension's Driver tab should be serving (#1237, #1332).
+ *
+ * Every web run's session inside the window, newest first, and all of them: one Driver tab serves
+ * the whole list by reading claude.ai's own session list and visiting only the sessions that need
+ * it (#1332), so a long list costs a sidebar read rather than a tab each — which is why the cap
+ * of three tabs this used to impose is gone.
+ *
+ * Recency is still the filter on this side, because a web run's own status says nothing: #1231
+ * ends the agent at the hand-off, so every one of them reads `done` whether its session is parked
+ * on a question or finished an hour ago. The read-back that tells those apart is the list status
+ * the Driver reports, and that lives in the bridge store, not on the record.
+ *
+ * `queuedFor` names every session the dashboard holds an answer for. Those are served whatever
+ * the window says — appended after the recent ones when no run of the window carries them —
+ * because a pick is made on a question the page reported, and the page reports whichever session
+ * the user happens to be on: outside the window, or no run's at all. A pick nothing serves would
+ * sit queued forever.
+ */
+export declare function bridgeSessionsFrom(agents: readonly AgentMeta[], now: Date, queuedFor: readonly string[], windowMs?: number): BridgeSession[];
+//# sourceMappingURL=bridge-sessions.d.ts.map

package/dist/dashboard/bridge-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-sessions.d.ts","sourceRoot":"","sources":["../../src/dashboard/bridge-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D,qHAAqH;AACrH,eAAO,MAAM,wBAAwB,QAA0B,CAAA;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,GAAG,EAAE,IAAI,EACT,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,SAA2B,GAClC,aAAa,EAAE,CAmBjB"}

package/dist/dashboard/bridge-sessions.js

@@ -0,0 +1,46 @@
+import { CLOUD_SESSION_WINDOW_MS } from '../cloud-run-state.js';
+/** How far back a cloud agent's session is still served: the session window, shared with its cloud state (#1668). */
+export const BRIDGE_SESSION_WINDOW_MS = CLOUD_SESSION_WINDOW_MS;
+/**
+ * Which cloud sessions the extension's Driver tab should be serving (#1237, #1332).
+ *
+ * Every web run's session inside the window, newest first, and all of them: one Driver tab serves
+ * the whole list by reading claude.ai's own session list and visiting only the sessions that need
+ * it (#1332), so a long list costs a sidebar read rather than a tab each — which is why the cap
+ * of three tabs this used to impose is gone.
+ *
+ * Recency is still the filter on this side, because a web run's own status says nothing: #1231
+ * ends the agent at the hand-off, so every one of them reads `done` whether its session is parked
+ * on a question or finished an hour ago. The read-back that tells those apart is the list status
+ * the Driver reports, and that lives in the bridge store, not on the record.
+ *
+ * `queuedFor` names every session the dashboard holds an answer for. Those are served whatever
+ * the window says — appended after the recent ones when no run of the window carries them —
+ * because a pick is made on a question the page reported, and the page reports whichever session
+ * the user happens to be on: outside the window, or no run's at all. A pick nothing serves would
+ * sit queued forever.
+ */
+export function bridgeSessionsFrom(agents, now, queuedFor, windowMs = BRIDGE_SESSION_WINDOW_MS) {
+    const queued = new Set(queuedFor);
+    const cutoff = now.getTime() - windowMs;
+    const seen = new Set();
+    const out = [];
+    for (const agent of agents) {
+        if (agent.target !== 'web' || !agent.sessionId)
+            continue;
+        const at = Date.parse(agent.startedAt ?? '');
+        if (!Number.isFinite(at) || at < cutoff)
+            continue;
+        if (seen.has(agent.sessionId))
+            continue;
+        seen.add(agent.sessionId);
+        out.push({
+            session: { id: agent.sessionId, url: `https://claude.ai/code/${agent.sessionId}`, answerQueued: queued.has(agent.sessionId) },
+            at,
+        });
+    }
+    const recent = out.sort((a, b) => b.at - a.at).map(entry => entry.session);
+    const extra = queuedFor.filter(id => !seen.has(id)).map(id => ({ id, url: `https://claude.ai/code/${id}`, answerQueued: true }));
+    return [...recent, ...extra];
+}
+//# sourceMappingURL=bridge-sessions.js.map

package/dist/dashboard/bridge-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-sessions.js","sourceRoot":"","sources":["../../src/dashboard/bridge-sessions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,qHAAqH;AACrH,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAA;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA4B,EAC5B,GAAS,EACT,SAA4B,EAC5B,QAAQ,GAAG,wBAAwB;IAEnC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAA;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAA6C,EAAE,CAAA;IACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAQ;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM;YAAE,SAAQ;QACjD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,SAAQ;QACvC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACzB,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,0BAA0B,KAAK,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;YAC7H,EAAE;SACH,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1E,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,0BAA0B,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAChI,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAA;AAC9B,CAAC"}

package/dist/dashboard/bridge-starts.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The session start-queue (#1328): cloud sessions the daemon wants the browser extension to
+ * create on claude.ai, because a session created through the page's repo picker is repo-bound
+ * and can push and open pull requests, which is what a hand-off is for.
+ *
+ * A run asks for a session and polls until it exists; the extension claims the oldest request,
+ * drives the page, and reports the session it became. The claim is the one subtle part: two
+ * polling tabs handed the same request would create two cloud sessions on the user's account,
+ * so a request leaves the queue in the same step that serves it, and comes back only if nobody
+ * reports on it within {@link START_CLAIM_TTL_MS} — a browser that quit mid-creation must retry,
+ * not brick the run.
+ */
+export type BridgeStartState = 'queued' | 'claimed' | 'created' | 'failed';
+export interface BridgeStartRequest {
+    id: string;
+    /** `owner/name`, as the repo picker lists it. */
+    repo: string;
+    /** The branch the session opens on — the run's pushed hand-off ref. */
+    branch: string;
+    prompt: string;
+    /** The model the run was started with (#1697), when it was; absent leaves claude.ai's default. */
+    model?: string;
+    queuedAt: string;
+    state: BridgeStartState;
+    claimedAt?: string;
+    sessionId?: string;
+    url?: string;
+    note?: string;
+}
+export interface BridgeStartInput {
+    repo: string;
+    branch: string;
+    prompt: string;
+    model?: string;
+}
+/** How long a claim stands before the request is offered again. */
+export declare const START_CLAIM_TTL_MS = 90000;
+/** The hand-off prompt is the session's whole task and everything it needs to know, so it can be long. */
+export declare const MAX_START_PROMPT = 200000;
+/** A model is a short name or id the extension matches against claude.ai's model menu (#1697). */
+export declare const MAX_START_MODEL = 100;
+export declare class BridgeStarts {
+    private readonly byId;
+    /** Queue a request, or say what is wrong with it. */
+    request(input: BridgeStartInput, now?: Date): BridgeStartRequest | string;
+    /** The oldest request nobody holds, claimed for the caller; an expired claim counts as unheld. */
+    claimNext(now?: Date): BridgeStartRequest | undefined;
+    /**
+     * The extension's word on a claimed request. Success without a session id is a failure: a run
+     * pointing nowhere is not a usable outcome. A report on a request nobody holds is ignored — a
+     * tab that died after its claim expired must not overwrite the retry that replaced it.
+     */
+    resolve(id: string, ok: boolean, sessionId?: string, note?: string): void;
+    get(id: string): BridgeStartRequest | undefined;
+    list(): BridgeStartRequest[];
+    clear(id: string): void;
+}
+/** The daemon's one queue: the run's request and the extension's claim must meet in the same store. */
+export declare function bridgeStarts(): BridgeStarts;
+export declare function resetBridgeStarts(): void;
+//# sourceMappingURL=bridge-starts.d.ts.map

package/dist/dashboard/bridge-starts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-starts.d.ts","sourceRoot":"","sources":["../../src/dashboard/bridge-starts.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE1E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,gBAAgB,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,QAAS,CAAA;AAKxC,0GAA0G;AAC1G,eAAO,MAAM,gBAAgB,SAAU,CAAA;AACvC,kGAAkG;AAClG,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAE7D,qDAAqD;IACrD,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAa,GAAG,kBAAkB,GAAG,MAAM,CAqB9E;IAED,kGAAkG;IAClG,SAAS,CAAC,GAAG,OAAa,GAAG,kBAAkB,GAAG,SAAS,CAU1D;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAaxE;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE9C;IAED,IAAI,IAAI,kBAAkB,EAAE,CAE3B;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtB;CACF;AAID,uGAAuG;AACvG,wBAAgB,YAAY,IAAI,YAAY,CAG3C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/dashboard/bridge-starts.js

@@ -0,0 +1,94 @@
+import { randomUUID } from 'node:crypto';
+/** How long a claim stands before the request is offered again. */
+export const START_CLAIM_TTL_MS = 90_000;
+const REPO = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/;
+const DOTS_ONLY = /^\.+$/;
+const BRANCH = /^[A-Za-z0-9._\-/]{1,255}$/;
+/** The hand-off prompt is the session's whole task and everything it needs to know, so it can be long. */
+export const MAX_START_PROMPT = 200_000;
+/** A model is a short name or id the extension matches against claude.ai's model menu (#1697). */
+export const MAX_START_MODEL = 100;
+export class BridgeStarts {
+    byId = new Map();
+    /** Queue a request, or say what is wrong with it. */
+    request(input, now = new Date()) {
+        const repo = input.repo.trim();
+        if (!REPO.test(repo) || repo.split('/').some(segment => DOTS_ONLY.test(segment)))
+            return 'repo must look like owner/name';
+        const branch = input.branch.trim();
+        if (!BRANCH.test(branch))
+            return 'branch must be a git branch name';
+        const prompt = input.prompt.trim();
+        if (!prompt)
+            return 'prompt must not be empty';
+        if (prompt.length > MAX_START_PROMPT)
+            return `prompt must be at most ${MAX_START_PROMPT} characters`;
+        const model = input.model?.trim();
+        if (model && model.length > MAX_START_MODEL)
+            return `model must be at most ${MAX_START_MODEL} characters`;
+        const start = {
+            id: randomUUID(),
+            repo,
+            branch,
+            prompt,
+            ...(model ? { model } : {}),
+            queuedAt: now.toISOString(),
+            state: 'queued',
+        };
+        this.byId.set(start.id, start);
+        return start;
+    }
+    /** The oldest request nobody holds, claimed for the caller; an expired claim counts as unheld. */
+    claimNext(now = new Date()) {
+        const stale = now.getTime() - START_CLAIM_TTL_MS;
+        const waiting = [...this.byId.values()]
+            .filter(start => start.state === 'queued' || (start.state === 'claimed' && Date.parse(start.claimedAt ?? '') <= stale))
+            .sort((a, b) => a.queuedAt.localeCompare(b.queuedAt));
+        const next = waiting[0];
+        if (!next)
+            return undefined;
+        const claimed = { ...next, state: 'claimed', claimedAt: now.toISOString() };
+        this.byId.set(claimed.id, claimed);
+        return claimed;
+    }
+    /**
+     * The extension's word on a claimed request. Success without a session id is a failure: a run
+     * pointing nowhere is not a usable outcome. A report on a request nobody holds is ignored — a
+     * tab that died after its claim expired must not overwrite the retry that replaced it.
+     */
+    resolve(id, ok, sessionId, note) {
+        const start = this.byId.get(id);
+        if (!start || start.state !== 'claimed')
+            return;
+        if (ok && !sessionId) {
+            this.byId.set(id, { ...start, state: 'failed', note: note ?? 'reported success without a session id' });
+            return;
+        }
+        this.byId.set(id, {
+            ...start,
+            state: ok ? 'created' : 'failed',
+            ...(sessionId ? { sessionId, url: `https://claude.ai/code/${sessionId}` } : {}),
+            ...(note ? { note } : {}),
+        });
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return [...this.byId.values()].sort((a, b) => b.queuedAt.localeCompare(a.queuedAt));
+    }
+    clear(id) {
+        this.byId.delete(id);
+    }
+}
+let instance;
+/** The daemon's one queue: the run's request and the extension's claim must meet in the same store. */
+export function bridgeStarts() {
+    if (!instance)
+        instance = new BridgeStarts();
+    return instance;
+}
+export function resetBridgeStarts() {
+    instance = undefined;
+}
+//# sourceMappingURL=bridge-starts.js.map

package/dist/dashboard/bridge-starts.js.map

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

package/dist/dashboard/bridge-store.d.ts

@@ -0,0 +1,179 @@
+import type { BridgeEvent, BridgeHello, BridgeQuestion, BridgeSessionStatus } from './bridge-endpoints.js';
+/**
+ * An answer picked in the dashboard, on its way back to the session (#1237).
+ *
+ * `queued` until the extension fetches it, delivers it into the composer and acknowledges;
+ * then `sent`, or `failed` with the extension's reason. The id is what the acknowledgement
+ * references, so a stale ack from a tab that died mid-delivery cannot resolve a newer answer.
+ */
+export interface BridgeAnswer {
+    id: string;
+    sessionId: string;
+    /** The label(s) picked — one, or a `multi` question's subset (possibly none). */
+    labels: string[];
+    /**
+     * What the extension types into the session (#1554): the same continuation a local gate
+     * re-prompts with, so a cloud session hears its answer exactly as a local one does — and, on a
+     * `stop` pick, that the user is taking over, since nothing of ours can end a session over there.
+     */
+    text: string;
+    queuedAt: string;
+    /**
+     * When a Driver collected it to type (#1332). Two Drivers can serve one daemon — the user's own
+     * Chrome and the daemon's bridge browser — and an answer handed to both would be typed twice.
+     */
+    claimedAt?: string;
+    state: 'queued' | 'sent' | 'failed';
+    note?: string;
+}
+/** How long a collected answer stays with the Driver that collected it before it is offered again. */
+export declare const ANSWER_CLAIM_TTL_MS = 90000;
+/**
+ * The questions a Claude web session is parked on, keyed by its cloud session id (#1237).
+ *
+ * A cloud agent has no live local session to hang a choice gate on: #1231 ends the agent at the
+ * hand-off, so by the time the agent asks anything the agent is already `done`. The join back to
+ * an agent is `AgentMeta.sessionId`, which a web agent already carries because `CloudSession` reports
+ * the cloud id on its result.
+ *
+ * In memory on purpose. A question is only answerable while the session that asked it is still
+ * parked, and the bridge that reported it re-reports on reconnect, so surviving a daemon restart
+ * would preserve a question that may already have been answered elsewhere.
+ */
+/** The last time anything spoke to the bridge, and how it went. */
+export interface BridgeContact {
+    at: string;
+    route: string;
+    status: number;
+}
+/** The extension's last version claim, and whether the doorway turned it away (#1519). */
+export interface BridgeVersion {
+    got: string;
+    expected: string;
+    blocked: boolean;
+    at: string;
+}
+/**
+ * What a cloud session is told when the user picks a `stop` option (#358, #1554). It lives on
+ * claude.ai where nothing of ours can end it, so the bridge types this instead of a continuation:
+ * the decision, and that the user is taking over from here.
+ */
+export declare function takeoverPrompt(question: string, answer: string): string;
+export declare class BridgeQuestions {
+    private readonly bySession;
+    private contact;
+    /**
+     * Note that something reached the bridge, whatever the outcome.
+     *
+     * Failures are recorded too, and that is the point: an extension that is misconfigured looks
+     * exactly like one that is not installed, because both leave no question behind. A refused
+     * request at least proves something is trying.
+     */
+    recordContact(route: string, status: number): void;
+    private versionState;
+    /**
+     * What version the extension last claimed and whether it was refused for it (#1519).
+     *
+     * The accepted claims are recorded too, which is what clears a blocked banner: the moment an
+     * updated extension gets through, the last word is no longer a refusal.
+     */
+    recordVersion(got: string, expected: string, blocked: boolean): void;
+    /** The last version claim, or undefined while nothing has stated one. */
+    version(): BridgeVersion | undefined;
+    private helloState;
+    /** What the injected page script last said about itself. */
+    recordHello(hello: BridgeHello): void;
+    /** The page script's last report, or undefined if none has ever arrived. */
+    hello(): BridgeHello | undefined;
+    /** The last contact, or undefined if nothing has ever reached the bridge. */
+    lastContact(): BridgeContact | undefined;
+    private readonly statusBySession;
+    /**
+     * What claude.ai's session list last said about a session (#1332), as the Driver tab read it.
+     *
+     * This is the read-back a web run's own record cannot give: the run ends at its hand-off, so
+     * the record says `done` whether the session is parked on its user or finished hours ago.
+     */
+    recordStatus(status: BridgeSessionStatus): void;
+    /** The session's last list status, or undefined while the Driver has never reported one. */
+    status(sessionId: string): BridgeSessionStatus | undefined;
+    /**
+     * Whether the session is waiting on a human: the bridge holds the question it is parked on, or
+     * claude.ai's list shows it awaiting input — a question asked in prose carries no block for
+     * the bridge to hold, and the list is the only thing that says the session stopped for it.
+     *
+     * A list status older than the session window no longer counts: the Driver stops reading a
+     * session past the window, so its last word would otherwise stand forever.
+     */
+    waiting(sessionId: string, now?: Date): boolean;
+    /**
+     * Whether an extension is around (#1328): something reached the bridge and was let in within
+     * the window. The worker polls every half minute while it lives, so a longer silence means
+     * there is nobody to drain a request.
+     */
+    extensionAlive(now?: Date, windowMs?: number): boolean;
+    private readonly eventsBySession;
+    /**
+     * Record one transcript entry, keyed by its position.
+     *
+     * Keyed rather than appended because the page is re-read on every DOM change, so the same
+     * message arrives repeatedly and a growing list would be mostly duplicates. Position also lets
+     * a later read replace an earlier one, which is what a message still being streamed needs.
+     */
+    recordEvent(event: BridgeEvent): void;
+    /** That session's transcript so far, in order. */
+    events(sessionId: string): BridgeEvent[];
+    private readonly answersBySession;
+    /** The fingerprint of the question each session's `sent` answer resolved. */
+    private readonly answeredBySession;
+    /**
+     * Record the question a session is parked on, replacing any earlier one for that session.
+     *
+     * A question identical to one an answer was already delivered for is dropped: the extension's
+     * worker forgets what it sent when it restarts, and the answered block stays in the page's DOM,
+     * so the same question would otherwise resurface as parked right after being answered.
+     */
+    record(question: BridgeQuestion): void;
+    /**
+     * Queue an answer picked in the dashboard (#1237). Refuses anything but labels of the question
+     * currently parked — exactly one unless the question is `multi` — so the only text this can
+     * ever put in a composer is composed from what the session itself offered.
+     */
+    queueAnswer(sessionId: string, labels: string[]): BridgeAnswer | string;
+    /** Withdraw a queued answer. Too late once a Driver has collected it or the extension has delivered it. */
+    cancelAnswer(sessionId: string, now?: number): boolean;
+    /** The answer waiting for the extension to deliver, if any — collected by a Driver or not. */
+    pendingAnswer(sessionId: string): BridgeAnswer | undefined;
+    /** Whether a Driver holds the answer: collected, and not so long ago that it is presumed lost. */
+    private claimed;
+    /**
+     * Hand the queued answer to the Driver asking, once (#1332): the next Driver asking within the
+     * claim's lifetime gets nothing, so a session served by two browsers is not answered twice. A
+     * claim nobody acknowledged — the Driver died mid-delivery — expires, and the answer is offered
+     * again.
+     */
+    claimAnswer(sessionId: string, now?: number): BridgeAnswer | undefined;
+    /**
+     * Every session with an answer waiting to be delivered. The Driver serves these whatever the
+     * session window says: the page reports whichever session the user is on, so a pick can be for
+     * a session no listed run carries, and one nothing serves would sit queued forever.
+     */
+    pendingAnswerSessions(): string[];
+    /** The session's answer in whatever state, for the dashboard to render. */
+    answer(sessionId: string): BridgeAnswer | undefined;
+    /**
+     * The extension's word on what happened to a delivery. On success the question is resolved:
+     * it is dropped, and re-reports of the same block are ignored (see {@link record}).
+     */
+    resolveAnswer(sessionId: string, id: string, ok: boolean, note?: string): void;
+    /** The question that session is parked on, if the bridge has reported one. */
+    get(sessionId: string): BridgeQuestion | undefined;
+    /** Every parked question, newest first. */
+    list(): BridgeQuestion[];
+    /** Drop a session's question, once it is answered or its agent is gone. */
+    clear(sessionId: string): void;
+}
+export declare function bridgeQuestions(): BridgeQuestions;
+/** Replace the store. Tests only: a module singleton would otherwise leak between them. */
+export declare function resetBridgeQuestions(): void;
+//# sourceMappingURL=bridge-store.d.ts.map

package/dist/dashboard/bridge-store.d.ts.map

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