@parlor/agent-ui 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cychien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @parlor/agent-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The agent's view of the app: route descriptions, views and the UI manifest an agent reads to know where the user is. Installed by `@parlor/client` and `@parlor/server`; you do not depend on it directly.
+
+```ts
+import { UI_MANIFEST_FILE } from "@parlor/agent-ui";
+
+console.log(UI_MANIFEST_FILE);
+```
+
+Docs: https://cychien.github.io/parlor/guides/agent-sidebar/

package/dist/client/agent-ui-client.d.ts

@@ -0,0 +1,60 @@
+import type { ClientChannel } from "@parlor/sync";
+import type { AnyRouter } from "@tanstack/router-core";
+import { type AgentOrigin, type ClientMessage, type QuerySnapshot, type RouteSnapshot, type ScreenSnapshot, type UiErrorCode, type UiOp } from "../protocol.js";
+import { type ConfirmationStore } from "./confirmations.js";
+import { type BrowserEnvironment } from "./environment.js";
+import { type ViewRegistry } from "./registry.js";
+import { type ScreenLimits } from "./screen.js";
+export interface QuerySource {
+    active(): readonly QuerySnapshot[];
+    settled(timeoutMs: number): Promise<void>;
+}
+export interface AgentUiClientOptions {
+    readonly router?: AnyRouter | undefined;
+    readonly queries: QuerySource;
+    readonly send: (message: ClientMessage) => Promise<string | undefined>;
+    readonly platform: string;
+    readonly buildId?: string | undefined;
+    readonly environment?: BrowserEnvironment | undefined;
+    readonly limits?: Partial<ScreenLimits> | undefined;
+    readonly settleMs?: number | undefined;
+    readonly dev?: boolean | undefined;
+}
+/** What an agent is doing on this screen: a UI op, or waiting for the user to confirm. */
+export type AgentActivityKind = UiOp | "confirm";
+/** How the app answered an operation: it did it, or refused with the error code the agent got. */
+export type AgentOutcome = {
+    readonly status: "done";
+} | {
+    readonly status: "refused";
+    readonly code: UiErrorCode;
+};
+export interface AgentActivity {
+    /** A request is running, or a confirmation card is waiting for the user on this client. */
+    readonly busy: boolean;
+    readonly last: {
+        readonly op: AgentActivityKind;
+        readonly origin: AgentOrigin;
+        readonly at: number;
+        /** Undefined while the operation runs, and for `confirm`, which the user answers. */
+        readonly outcome?: AgentOutcome | undefined;
+    } | undefined;
+}
+export interface ActivityStore {
+    subscribe(listener: () => void): () => void;
+    get(): AgentActivity;
+}
+export interface AgentUiClient extends ClientChannel {
+    readonly views: ViewRegistry;
+    readonly activity: ActivityStore;
+    readonly confirmations: ConfirmationStore;
+    screen(): Promise<ScreenSnapshot>;
+    start(): () => void;
+    /** Forgets what belongs to the signed-in user: the pending confirmations. */
+    reset(): void;
+    /** Declares a chat thread shown here until the returned function runs (presence `watching`). */
+    watch(threadId: string): () => void;
+}
+export declare function routeSnapshot(router: AnyRouter): RouteSnapshot | null;
+export declare function createAgentUiClient(options: AgentUiClientOptions): AgentUiClient;
+//# sourceMappingURL=agent-ui-client.d.ts.map

package/dist/client/agent-ui-client.d.ts.map

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

package/dist/client/agent-ui-client.js

@@ -0,0 +1,407 @@
+import { MAX_WATCHED_THREADS, parseUiFrame, UI_CHANNEL, UI_OPS, } from "../protocol.js";
+import {} from "../view.js";
+import { createConfirmationStore } from "./confirmations.js";
+import { browserEnvironment } from "./environment.js";
+import { createHighlightMarks, highlightView } from "./highlight.js";
+import { createViewRegistry } from "./registry.js";
+import { captureScreen, DEFAULT_SCREEN_LIMITS } from "./screen.js";
+import { setView } from "./write.js";
+const REPLY_CACHE_SIZE = 64;
+const DEFAULT_SETTLE_MS = 1500;
+const OBSERVER_WAIT_MS = 100;
+export function routeSnapshot(router) {
+    const { matches, location } = router.state;
+    const leaf = matches.at(-1);
+    if (!leaf)
+        return null;
+    if (matches.some((match) => match._notFound)) {
+        return { notFound: true, url: location.href };
+    }
+    return {
+        notFound: false,
+        path: leaf.fullPath,
+        params: leaf.params,
+        search: location.search,
+        url: location.href,
+    };
+}
+function createActivityStore() {
+    const listeners = new Set();
+    let running = false;
+    let pending = 0;
+    let last;
+    let state = { busy: false, last: undefined };
+    const publish = () => {
+        state = { busy: running || pending > 0, last };
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        get: () => state,
+        begin(request, at) {
+            running = true;
+            last = { op: request.op, origin: request.origin, at, outcome: undefined };
+            publish();
+        },
+        end(reply) {
+            running = false;
+            if (last && last.op !== "confirm") {
+                last = {
+                    ...last,
+                    outcome: reply.ok
+                        ? { status: "done" }
+                        : { status: "refused", code: reply.error.code },
+                };
+            }
+            publish();
+        },
+        confirming(count, arrived) {
+            pending = count;
+            if (arrived)
+                last = { op: "confirm", origin: arrived.origin, at: arrived.at };
+            publish();
+        },
+        watched: () => listeners.size > 0,
+    };
+}
+export function createAgentUiClient(options) {
+    const env = options.environment ?? browserEnvironment();
+    const limits = { ...DEFAULT_SCREEN_LIMITS, ...options.limits };
+    const registry = createViewRegistry(env);
+    const unlistedWarned = new Set();
+    const warnIfUnlisted = (view) => {
+        const router = options.router;
+        if (!options.dev || !router || unlistedWarned.has(view.name))
+            return;
+        const matches = router.state.matches;
+        if (matches.some((match) => match.staticData?.views?.includes(view)))
+            return;
+        unlistedWarned.add(view.name);
+        console.warn(`[parlor] The agent view "${view.name}" mounted on ${router.state.location.pathname}, but no matched route lists it in staticData.views, so the manifest cannot tell agents where it lives.`);
+    };
+    const views = {
+        track(view, binding) {
+            const slot = registry.track(view, binding);
+            return {
+                ...slot,
+                mount(key) {
+                    warnIfUnlisted(view);
+                    return slot.mount(key);
+                },
+            };
+        },
+    };
+    const activity = createActivityStore();
+    const marks = createHighlightMarks(env);
+    const confirmations = createConfirmationStore({
+        env,
+        answer: (id, approve) => post({ type: "answer", id, approve }),
+        onWatchedChange: () => schedulePresence(),
+        onChange: () => {
+            const showing = confirmations.get();
+            const arrived = showing.filter((item) => !seenCards.has(item.id)).at(-1);
+            for (const item of showing)
+                seenCards.add(item.id);
+            activity.confirming(showing.length, arrived && { origin: arrived.origin, at: env.now() });
+        },
+    });
+    const seenCards = new Set();
+    const replies = new Map();
+    const queued = new Set();
+    const queue = [];
+    let draining = false;
+    let warnedUnwatched = false;
+    const deliver = (message) => options.send(message).then((next) => {
+        if (next !== undefined)
+            receive(next);
+    }, () => { });
+    const post = (message) => void deliver(message);
+    let lifecycleTail;
+    const postInOrder = (message) => {
+        const delivered = lifecycleTail === undefined
+            ? deliver(message)
+            : lifecycleTail.then(() => deliver(message));
+        const tail = delivered.finally(() => {
+            if (lifecycleTail === tail)
+                lifecycleTail = undefined;
+        });
+        lifecycleTail = tail;
+    };
+    const observed = async () => {
+        // A hidden page does not render, so its observer stays silent until it is shown.
+        if (!registry.awaitingObserver() || env.document?.visibilityState !== "visible") {
+            return;
+        }
+        let timer;
+        await Promise.race([
+            registry.observed(),
+            new Promise((resolve) => {
+                timer = env.setTimeout(resolve, OBSERVER_WAIT_MS);
+            }),
+        ]);
+        env.clearTimeout(timer);
+    };
+    const screen = async () => {
+        await observed();
+        return captureScreen(registry, {
+            route: () => (options.router ? routeSnapshot(options.router) : null),
+            queries: () => options.queries.active(),
+        }, env, limits);
+    };
+    const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;
+    const navigate = async (input) => {
+        const router = options.router;
+        if (!router) {
+            return {
+                code: "unknown_route",
+                message: "This app did not give FrameworkProvider a router, so it cannot navigate.",
+            };
+        }
+        if (!Object.hasOwn(router.routesByPath, input.to)) {
+            return { code: "unknown_route", message: `This app has no route ${input.to}.` };
+        }
+        const deadline = env.now() + settleMs;
+        let timer;
+        await Promise.race([
+            router.navigate({
+                to: input.to,
+                ...(input.params ? { params: input.params } : {}),
+                ...(input.search ? { search: input.search } : {}),
+                ...(input.replace === undefined ? {} : { replace: input.replace }),
+            }),
+            new Promise((resolve) => {
+                timer = env.setTimeout(resolve, settleMs);
+            }),
+        ]);
+        env.clearTimeout(timer);
+        await env.nextTask();
+        await options.queries.settled(Math.max(0, deadline - env.now()));
+        await env.nextTask();
+        return screen();
+    };
+    const execute = async (request) => {
+        const ok = (result) => ({
+            type: "reply",
+            id: request.id,
+            ok: true,
+            result,
+        });
+        const fail = (error) => ({
+            type: "reply",
+            id: request.id,
+            ok: false,
+            error,
+        });
+        try {
+            switch (request.op) {
+                case "screen":
+                    return ok(await screen());
+                case "navigate": {
+                    const outcome = await navigate(request.input);
+                    return "code" in outcome ? fail(outcome) : ok({ screen: outcome });
+                }
+                case "set": {
+                    const outcome = await setView(registry, request.input, env);
+                    return "code" in outcome ? fail(outcome) : ok(outcome);
+                }
+                case "highlight": {
+                    const outcome = await highlightView(registry, request.input, env, marks);
+                    return "code" in outcome ? fail(outcome) : ok(outcome);
+                }
+            }
+        }
+        catch (error) {
+            return fail({
+                code: "internal",
+                message: error instanceof Error ? error.message : "The app failed to answer.",
+            });
+        }
+    };
+    const remember = (reply) => {
+        replies.set(reply.id, reply);
+        if (replies.size > REPLY_CACHE_SIZE)
+            replies.delete(replies.keys().next().value);
+        post(reply);
+    };
+    const drain = async () => {
+        if (draining)
+            return;
+        draining = true;
+        while (queue.length > 0) {
+            const request = queue.shift();
+            activity.begin(request, env.now());
+            const reply = await execute(request);
+            queued.delete(request.id);
+            remember(reply);
+            activity.end(reply);
+        }
+        draining = false;
+    };
+    const warnIfUnwatched = () => {
+        if (!options.dev || warnedUnwatched || activity.watched())
+            return;
+        warnedUnwatched = true;
+        console.warn("[parlor] An agent is reading or driving this screen, but nothing renders useAgentActivity(). Show users when an agent is at work by building an indicator on useAgentActivity().");
+    };
+    const watched = new Map();
+    let lastPresence;
+    let gone = false;
+    let connected = false;
+    let presenceTimer;
+    const presence = () => {
+        const visible = env.document?.visibilityState === "visible";
+        return {
+            type: "presence",
+            focused: visible && (env.document?.hasFocus() ?? false),
+            visible,
+            platform: options.platform,
+            ...(options.buildId === undefined ? {} : { buildId: options.buildId }),
+            ops: UI_OPS,
+            canConfirm: confirmations.watched(),
+            ...(watched.size > 0
+                ? { watching: [...watched.keys()].slice(0, MAX_WATCHED_THREADS) }
+                : {}),
+        };
+    };
+    const reportPresence = () => {
+        if (gone || !connected)
+            return;
+        const update = presence();
+        const serialized = JSON.stringify(update);
+        if (serialized === lastPresence)
+            return;
+        lastPresence = serialized;
+        postInOrder(update);
+    };
+    const schedulePresence = () => {
+        if (presenceTimer !== undefined)
+            return;
+        presenceTimer = env.setTimeout(() => {
+            presenceTimer = undefined;
+            reportPresence();
+        }, 0);
+    };
+    const leave = () => {
+        gone = true;
+        lastPresence = undefined;
+        if (presenceTimer !== undefined)
+            env.clearTimeout(presenceTimer);
+        presenceTimer = undefined;
+        postInOrder({ type: "leave" });
+    };
+    const resume = () => {
+        gone = false;
+        schedulePresence();
+    };
+    const presenceTargets = () => [
+        [env.window, "focus", schedulePresence],
+        [env.window, "blur", schedulePresence],
+        [env.window, "pageshow", resume],
+        [env.window, "pagehide", leave],
+        [env.document, "visibilitychange", schedulePresence],
+    ];
+    let presenceAttached = false;
+    const attachPresence = () => {
+        if (presenceAttached)
+            return;
+        presenceAttached = true;
+        for (const [target, event, listener] of presenceTargets()) {
+            target?.addEventListener(event, listener);
+        }
+    };
+    const detachPresence = () => {
+        presenceAttached = false;
+        for (const [target, event, listener] of presenceTargets()) {
+            target?.removeEventListener(event, listener);
+        }
+        if (presenceTimer !== undefined)
+            env.clearTimeout(presenceTimer);
+        presenceTimer = undefined;
+        lastPresence = undefined;
+    };
+    const receive = (data) => {
+        const parsed = parseUiFrame(data);
+        if (!parsed.ok) {
+            if (parsed.id !== undefined) {
+                remember({
+                    type: "reply",
+                    id: parsed.id,
+                    ok: false,
+                    error: {
+                        code: "internal",
+                        message: "The app could not read this UI request.",
+                    },
+                });
+            }
+            return;
+        }
+        const { frame: request } = parsed;
+        if (!("op" in request)) {
+            confirmations.replace(request.items);
+            return;
+        }
+        const cached = replies.get(request.id);
+        if (cached) {
+            post(cached);
+            return;
+        }
+        if (queued.has(request.id))
+            return;
+        warnIfUnwatched();
+        queued.add(request.id);
+        queue.push(request);
+        void drain();
+    };
+    return {
+        event: UI_CHANNEL,
+        views,
+        activity,
+        confirmations,
+        screen,
+        opened() {
+            gone = false;
+            connected = true;
+            attachPresence();
+            lastPresence = undefined;
+            reportPresence();
+        },
+        closed() {
+            connected = false;
+            detachPresence();
+        },
+        receive,
+        watch(threadId) {
+            watched.set(threadId, (watched.get(threadId) ?? 0) + 1);
+            schedulePresence();
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                const remaining = (watched.get(threadId) ?? 1) - 1;
+                if (remaining > 0)
+                    watched.set(threadId, remaining);
+                else
+                    watched.delete(threadId);
+                schedulePresence();
+            };
+        },
+        reset() {
+            confirmations.replace([]);
+        },
+        start() {
+            registry.resume();
+            return () => {
+                registry.dispose();
+                marks.dispose();
+                confirmations.dispose();
+                detachPresence();
+            };
+        },
+    };
+}
+//# sourceMappingURL=agent-ui-client.js.map

package/dist/client/agent-ui-client.js.map

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

package/dist/client/confirmations.d.ts

@@ -0,0 +1,34 @@
+import type { AgentOrigin, ConfirmationPrompt } from "../protocol.js";
+import type { BrowserEnvironment } from "./environment.js";
+/** A pending agent request the user must approve, as an app renders it. */
+export interface AgentConfirmation {
+    readonly id: string;
+    readonly action: string;
+    readonly description: string;
+    /** The validated input the action will run with, as JSON. */
+    readonly input: unknown;
+    readonly origin: AgentOrigin;
+    /** Local `Date.now()` time after which the server stops waiting. */
+    readonly expiresAt: number;
+    /** The chat thread an inline agent asked from; the chat shows the card inline there. */
+    readonly threadId?: string | undefined;
+    readonly approve: () => void;
+    readonly decline: () => void;
+}
+export interface ConfirmationStore {
+    subscribe(listener: () => void): () => void;
+    get(): readonly AgentConfirmation[];
+}
+export interface ConfirmationStoreRuntime extends ConfirmationStore {
+    replace(items: readonly ConfirmationPrompt[]): void;
+    watched(): boolean;
+    dispose(): void;
+}
+export interface ConfirmationStoreOptions {
+    readonly env: Pick<BrowserEnvironment, "now" | "setTimeout" | "clearTimeout">;
+    readonly answer: (id: string, approve: boolean) => void;
+    readonly onWatchedChange: () => void;
+    readonly onChange: () => void;
+}
+export declare function createConfirmationStore(options: ConfirmationStoreOptions): ConfirmationStoreRuntime;
+//# sourceMappingURL=confirmations.d.ts.map

package/dist/client/confirmations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmations.d.ts","sourceRoot":"","sources":["../../src/client/confirmations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,GAAG,IAAI,SAAS,iBAAiB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,OAAO,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACpD,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC,CAAC;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAoBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAoF1B"}

package/dist/client/confirmations.js

@@ -0,0 +1,95 @@
+const signatureOf = (prompt) => JSON.stringify([
+    prompt.action,
+    prompt.description,
+    prompt.input,
+    prompt.origin.via,
+    prompt.origin.name,
+    prompt.threadId,
+]);
+const sameItems = (a, b) => a.length === b.length && a.every((item, index) => item === b[index]);
+export function createConfirmationStore(options) {
+    const { env } = options;
+    const listeners = new Set();
+    let entries = new Map();
+    const answered = new Set();
+    let visible = [];
+    let expiry;
+    const scheduleExpiry = () => {
+        env.clearTimeout(expiry);
+        expiry = undefined;
+        if (visible.length === 0)
+            return;
+        const next = Math.min(...visible.map((item) => item.expiresAt));
+        expiry = env.setTimeout(expire, Math.max(0, next - env.now()));
+    };
+    const commit = () => {
+        const next = [...entries.values()]
+            .map((entry) => entry.item)
+            .filter((item) => !answered.has(item.id));
+        if (sameItems(next, visible))
+            return;
+        visible = next;
+        scheduleExpiry();
+        for (const listener of listeners)
+            listener();
+        options.onChange();
+    };
+    function expire() {
+        const now = env.now();
+        entries = new Map([...entries].filter(([, entry]) => entry.item.expiresAt > now));
+        commit();
+        scheduleExpiry();
+    }
+    const respond = (id, approve) => {
+        if (answered.has(id))
+            return;
+        answered.add(id);
+        options.answer(id, approve);
+        commit();
+    };
+    const itemOf = (prompt) => ({
+        id: prompt.id,
+        action: prompt.action,
+        description: prompt.description,
+        input: prompt.input,
+        origin: prompt.origin,
+        expiresAt: env.now() + prompt.expiresInMs,
+        threadId: prompt.threadId,
+        approve: () => respond(prompt.id, true),
+        decline: () => respond(prompt.id, false),
+    });
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            if (listeners.size === 1)
+                options.onWatchedChange();
+            return () => {
+                if (!listeners.delete(listener))
+                    return;
+                if (listeners.size === 0)
+                    options.onWatchedChange();
+            };
+        },
+        get: () => visible,
+        replace(prompts) {
+            const next = new Map();
+            for (const prompt of prompts) {
+                const signature = signatureOf(prompt);
+                const known = entries.get(prompt.id);
+                next.set(prompt.id, known?.signature === signature ? known : { signature, item: itemOf(prompt) });
+            }
+            entries = next;
+            for (const id of answered)
+                if (!next.has(id))
+                    answered.delete(id);
+            commit();
+        },
+        watched: () => listeners.size > 0,
+        dispose() {
+            env.clearTimeout(expiry);
+            expiry = undefined;
+            listeners.clear();
+        },
+    };
+}
+//# sourceMappingURL=confirmations.js.map