@north-light/crouter 0.3.318 → 0.3.319

package/dist/clients/inbox/controller.js

@@ -1,701 +1 @@
-import { existsSync, watch } from 'node:fs';
-import { visibleWidth } from '@earendil-works/pi-tui';
-import { renderMarkdown } from '../../core/termrender/termrender.js';
-import { BOLD, CYAN, DIM, GRAY, RESET, YELLOW, clipLine } from './tui/ansi.js';
-import { buildInboxLines, recommendedLabel } from './tui.js';
-import { inboxLayout } from './layout.js';
-import { resolvePageComponents } from '../../core/config.js';
-import { watchInboxActivity } from '../../core/human/root.js';
-import { claimTicket, heartbeatClaim, releaseClaim } from '../../core/human/claim.js';
-import { claimPath, clearProgress } from '../../core/human/convention.js';
-import { emitEvent } from '../../core/events/emit.js';
-import { cliClient } from '../../commands/api-client.js';
-import { projectPageDisplayMarkdown } from '../../core/human/page-markdown.js';
-import { projectHtmlDocumentMarkdown } from '../../core/human/page-html-markdown.js';
-import { pageBodyLines } from './tui/page-body.js';
-import { byNewestFirst, inboxRowFromDTO, pageViewFromDTO, settledStatusOf } from './dto-adapt.js';
-import { PageAdapter } from './page-adapter.js';
-import { ReviewAdapter } from './review-adapter.js';
-import { createReviewClient } from './review/review-client.js';
-import { editBufferInEditor } from './review/roundtrip.js';
-import { daemonErrorMessage, dismissTicketViaDaemon, resolveFailureKind, resolveTicketPage, } from './resolve.js';
-/** Host-agnostic model for scanning, stable selection, claims, and rendering. */
-export class InboxController {
-    options;
-    host;
-    scan;
-    items = [];
-    selectedDir;
-    selectedIndex = 0;
-    screen = 'list';
-    adapter;
-    reviewAdapter;
-    focusingSource = false;
-    claim;
-    submittingDir;
-    cancelConfirmation;
-    cols;
-    rows;
-    status;
-    watchers = [];
-    selectedWatcher;
-    heartbeat;
-    started = false;
-    closed = false;
-    /** The selected page's projection, kept across frames because fetching it is
-     *  a round trip. `view` is held so a width change re-wraps without one. */
-    preview;
-    /** A preview read that failed, so the panel says so instead of staying blank. */
-    previewFailed;
-    /** In-flight preview fetch, keyed by dir: one request per selection at a time. */
-    previewFetching;
-    /** Set by `invalidate`: the held preview may no longer be the current revision. */
-    previewStale = false;
-    /** The revision the open detail was loaded from, so a replacement published
-     *  while the reader has the page open reloads it. */
-    openRevision;
-    constructor(options) {
-        this.options = options;
-        this.host = options.host;
-        this.scan = options.scan ?? defaultScan;
-        this.cols = options.cols ?? 80;
-        this.rows = options.rows ?? 24;
-        // Seeded before the first rescan, which preserves a selected dir it finds.
-        this.selectedDir = options.initialSelection;
-        void this.rescan();
-    }
-    snapshot() {
-        return { items: [...this.items], selectedDir: this.selectedDir, screen: this.screen, inputBuffer: this.adapter?.inputBuffer() };
-    }
-    async rescan() {
-        const priorDir = this.selectedDir;
-        const priorIndex = this.selectedIndex;
-        const claim = this.claim;
-        // The row list is a round trip, and most rescans are fired from inbox
-        // activity with nobody awaiting them. A failed read keeps the rows already
-        // on screen and says so in the status line, rather than rejecting into a
-        // caller that cannot handle it.
-        try {
-            this.items = await this.scan();
-        }
-        catch (error) {
-            if (this.closed)
-                return;
-            this.status = daemonErrorMessage(error);
-            this.markDirty();
-            return;
-        }
-        if (this.closed)
-            return;
-        const found = priorDir === undefined ? -1 : this.items.findIndex((item) => item.dir === priorDir);
-        if (found >= 0) {
-            this.selectedIndex = found;
-            this.selectedDir = priorDir;
-            return;
-        }
-        if (this.adapter !== undefined && priorDir !== undefined && claim !== undefined) {
-            const canceled = (await this.requestOrNull(claim.id))?.state === 'canceled';
-            if (this.closed)
-                return;
-            if (canceled)
-                clearProgress(priorDir);
-            // Suppress the "resolved elsewhere" banner when WE are the ones resolving
-            // this ticket: the settlement we just submitted drops the row from the
-            // scan mid-submit, and that is our own completion, not an external event.
-            if (priorDir !== this.submittingDir)
-                this.status = canceled ? 'canceled by requester' : 'ticket resolved elsewhere';
-            this.leaveDetail(priorDir !== this.submittingDir);
-        }
-        if (this.items.length === 0) {
-            this.selectedIndex = 0;
-            this.selectedDir = undefined;
-            return;
-        }
-        this.selectedIndex = Math.min(priorIndex, this.items.length - 1);
-        this.selectedDir = this.items[this.selectedIndex].dir;
-    }
-    start() {
-        if (this.started || this.closed)
-            return;
-        this.started = true;
-        this.watchRoots();
-        this.heartbeat = setInterval(() => {
-            if (this.claim !== undefined)
-                heartbeatClaim(this.claim.dir, this.claim.token);
-        }, 10_000);
-    }
-    /** Inbox activity is the one signal a replacement always emits, and it is
-     *  emitted after the new revision is selected — so an open page reloads here
-     *  rather than from a file watch that cannot see a directory swap. */
-    async invalidate() {
-        // Activity is the one signal a replacement always emits, and it fires after
-        // the new revision is selected — so the held preview and any open page are
-        // re-read from the daemon here rather than from a file watch, which cannot
-        // see a directory swap at all.
-        this.previewStale = true;
-        await this.rescan();
-        if (this.closed)
-            return;
-        if (this.adapter !== undefined && this.claim !== undefined) {
-            await this.reloadSelectedPage();
-            return;
-        }
-        this.markDirty();
-    }
-    resize(cols, rows) {
-        this.cols = cols;
-        this.rows = rows;
-        this.adapter?.resize(this.detailSize().cols, this.detailSize().rows);
-        this.markDirty();
-    }
-    render() {
-        const geometry = inboxLayout(this.cols, this.rows, this.screen);
-        if (geometry.mode === 'minimum')
-            return [`${YELLOW}Resize terminal to at least 60×18 to use inbox.${RESET}`];
-        const list = buildInboxLines(this.items, geometry.listWidth, this.selectedIndex, geometry.height);
-        const detail = this.detailLines(geometry.detailWidth, geometry.height);
-        if (geometry.mode === 'list')
-            return this.withStatus(list);
-        if (geometry.mode === 'detail')
-            return this.withStatus(detail);
-        const lines = [];
-        // Dim box-drawing rule in the single-column gutter the layout reserves
-        // (detailWidth = cols - listWidth - 1) so the list and detail read as two
-        // distinct panels rather than one run-together block.
-        const divider = `${GRAY}│${RESET}`;
-        for (let i = 0; i < geometry.height; i++) {
-            // Hard-clip the list line to its column: an overflowing row would eat
-            // the pad and push the divider out of alignment for that row alone.
-            const left = clipLine(list[i] ?? '', geometry.listWidth);
-            // Clip the detail column too: a preview row is only ever entitled to
-            // its own panel, so an over-wide row cannot run past the pane's edge.
-            const right = clipLine(detail[i] ?? '', geometry.detailWidth);
-            const pad = ' '.repeat(Math.max(0, geometry.listWidth - visibleWidth(left)));
-            lines.push(`${left}${pad}${divider}${right}`);
-        }
-        return this.withStatus(lines);
-    }
-    handleKey(input, key) {
-        // Ctrl-C closes from every controller mode before adapter forwarding.
-        // The inbox toggle is a host action, never a surface key chord.
-        if (key.ctrl && input === 'c') {
-            this.close();
-            return;
-        }
-        if (this.screen === 'detail' && this.adapter !== undefined) {
-            if ((input === 'g' || input === 'G') && this.adapter.canAcceptHostKeys()) {
-                void this.focusSelectedSource();
-                return;
-            }
-            this.adapter.handleKey(input, key);
-            this.markDirty();
-            return;
-        }
-        if (this.cancelConfirmation !== undefined) {
-            if (input === 'y' || input === 'Y') {
-                const item = this.cancelConfirmation.item;
-                this.cancelConfirmation = undefined;
-                this.status = 'canceling…';
-                void this.cancelFromInbox(item);
-            }
-            else if (input === 'n' || input === 'N' || key.escape) {
-                this.cancelConfirmation = undefined;
-                this.status = undefined;
-            }
-            this.markDirty();
-            return;
-        }
-        if (input === 'x' || input === 'X') {
-            const selected = this.items[this.selectedIndex];
-            if (selected !== undefined) {
-                this.cancelConfirmation = { item: selected };
-                this.status = undefined;
-            }
-            this.markDirty();
-            return;
-        }
-        if (input === 's' || input === 'S') {
-            void this.sendFastAction();
-            this.markDirty();
-            return;
-        }
-        if (key.escape || input === 'q') {
-            this.close();
-            return;
-        }
-        if (input === 'j' || key.downArrow)
-            this.select(this.selectedIndex + 1);
-        else if (input === 'k' || key.upArrow)
-            this.select(this.selectedIndex - 1);
-        else if (input === 'g' || input === 'G')
-            void this.focusSelectedSource();
-        else if (key.return || input === 'a')
-            void this.activate();
-        this.markDirty();
-    }
-    /** Settle the selected ticket from the list with what crouter already put on
-     *  its summary — the agent's recommended option, or a notice's empty map. A
-     *  row without a fast action says so rather than opening the page: the key
-     *  means one thing, and the page is what Enter is for. */
-    async sendFastAction() {
-        const item = this.items[this.selectedIndex];
-        if (item === undefined)
-            return;
-        if (item.kind !== 'page' || item.fastAction === undefined) {
-            this.status = 'no recommended answer on this ticket — Enter opens it';
-            return;
-        }
-        // Settlement is a daemon-owned state, so a claim still succeeds on a
-        // settled request's directory. The record decides whether this row is
-        // stale; only then does a refused claim mean another inbox holds it.
-        const request = await this.requestOrNull(item.id);
-        if (isSettled(request)) {
-            this.status = settledStatus(request);
-            await this.rescan();
-            return;
-        }
-        const claim = claimTicket(item.dir);
-        if (claim === null) {
-            this.status = 'ticket is being edited by another inbox';
-            return;
-        }
-        const settled = item.fastAction.kind === 'acknowledge'
-            ? 'acknowledged'
-            : `sent: ${recommendedLabel(item) ?? 'recommended answer'}`;
-        this.submittingDir = item.dir;
-        try {
-            await resolveTicketPage(item.id, item.fastAction.responses);
-            this.status = settled;
-        }
-        catch (error) {
-            this.status = resolveFailureKind(error) === 'already_settled'
-                ? settledStatus(await this.requestOrNull(item.id))
-                : daemonErrorMessage(error);
-        }
-        finally {
-            releaseClaim(item.dir, claim.token);
-            this.submittingDir = undefined;
-            await this.rescan();
-            this.markDirty();
-        }
-    }
-    /** A review and a page are two different durable records; the inbox dismisses
-     *  whichever one the selected row actually is. */
-    async cancelFromInbox(item) {
-        this.submittingDir = item.dir;
-        try {
-            if (item.kind === 'review')
-                await createReviewClient().cancel(item.id, 'Canceled from the inbox.');
-            else
-                await dismissTicketViaDaemon(item.id, { reason: 'Canceled from the inbox.', actor: 'human' });
-            this.status = 'canceled';
-        }
-        catch (error) {
-            this.status = daemonErrorMessage(error);
-        }
-        finally {
-            this.submittingDir = undefined;
-            await this.rescan();
-            this.markDirty();
-        }
-    }
-    async activate() {
-        const item = this.items[this.selectedIndex];
-        if (item === undefined)
-            return;
-        if (item.kind === 'review') {
-            await this.activateReview(item);
-            return;
-        }
-        const request = await this.requestOrNull(item.id);
-        if (this.closed)
-            return;
-        if (isSettled(request)) {
-            this.status = settledStatus(request);
-            await this.rescan();
-            return;
-        }
-        const claim = claimTicket(item.dir);
-        if (claim === null) {
-            this.status = 'ticket is being edited by another inbox';
-            return;
-        }
-        // One projection carries the revision AND the content it belongs to, so
-        // there is no window between reading the two in which a replacement lands.
-        let view;
-        let revision;
-        try {
-            const page = await cliClient().getHumanInboxPage(item.inboxTicketId);
-            // The claim is a presenter lock, not settlement authority, so a request
-            // that settled between the pre-claim check and this read would still
-            // claim. This projection already carries the state that decides it.
-            if (page.state === 'resolved' || page.state === 'canceled') {
-                releaseClaim(item.dir, claim.token);
-                this.status = settledStatusOf(page);
-                await this.rescan();
-                return;
-            }
-            view = pageViewFromDTO(page);
-            revision = page.revision;
-        }
-        catch {
-            releaseClaim(item.dir, claim.token);
-            this.status = 'page could not be read';
-            await this.invalidate();
-            return;
-        }
-        // Another activation (or a close) may have landed while this read was in
-        // flight; that one owns the detail screen, so this claim is released.
-        if (this.closed || this.claim !== undefined || this.adapter !== undefined) {
-            releaseClaim(item.dir, claim.token);
-            return;
-        }
-        this.claim = { dir: item.dir, id: item.id, ticketId: item.inboxTicketId, token: claim.token };
-        this.screen = 'detail';
-        this.adapter = new PageAdapter({
-            ticketId: item.inboxTicketId,
-            page: view,
-            productKinds: resolvePageComponents(),
-            cols: this.detailSize().cols,
-            rows: this.detailSize().rows,
-            onDirty: () => this.markDirty(),
-            onEditorRequest: () => this.editActivePageInput(),
-            onBack: () => { this.leaveDetail(); this.markDirty(); },
-            onComplete: (responses) => { void this.complete(responses); },
-        });
-        this.openRevision = revision;
-        this.watchSelected(item.dir);
-        this.markDirty();
-    }
-    async activateReview(item) {
-        this.reviewAdapter = new ReviewAdapter({
-            reviewId: item.id,
-            host: this.host,
-        });
-        try {
-            await this.reviewAdapter.start();
-        }
-        catch (error) {
-            this.status = daemonErrorMessage(error);
-        }
-        finally {
-            this.reviewAdapter = undefined;
-            await this.rescan();
-            this.markDirty();
-        }
-    }
-    /** Seat the selection on a ticket dir, when present in the current list. */
-    selectDir(dir) {
-        const index = this.items.findIndex((item) => item.dir === dir);
-        if (index >= 0) {
-            this.select(index);
-            this.markDirty();
-        }
-    }
-    /** Re-read the open page and reload it only when its revision actually moved. */
-    async reloadSelectedPage() {
-        const claim = this.claim;
-        if (this.adapter === undefined || claim === undefined) {
-            this.markDirty();
-            return;
-        }
-        try {
-            const page = await cliClient().getHumanInboxPage(claim.ticketId);
-            if (this.closed || this.claim !== claim || this.adapter === undefined)
-                return;
-            if (page.revision !== this.openRevision) {
-                this.openRevision = page.revision;
-                this.adapter.reload(pageViewFromDTO(page));
-            }
-        }
-        catch {
-            this.status = 'page could not be read';
-        }
-        this.markDirty();
-    }
-    close() {
-        if (this.closed)
-            return;
-        this.closed = true;
-        this.started = false;
-        if (this.heartbeat !== undefined)
-            clearInterval(this.heartbeat);
-        this.heartbeat = undefined;
-        void this.reviewAdapter?.stop();
-        this.leaveDetail(this.claim?.dir !== this.submittingDir);
-        for (const watcher of this.watchers)
-            watcher.close();
-        this.watchers = [];
-        this.selectedWatcher?.close();
-        this.selectedWatcher = undefined;
-        this.options.onClosed();
-    }
-    async complete(responses) {
-        const claim = this.claim;
-        if (claim === undefined)
-            return;
-        this.submittingDir = claim.dir;
-        try {
-            await resolveTicketPage(claim.id, responses);
-        }
-        catch (error) {
-            this.submittingDir = undefined;
-            this.status = daemonErrorMessage(error);
-            const failure = resolveFailureKind(error);
-            if (failure === 'unreachable' || failure === 'other') {
-                this.markDirty();
-                return;
-            }
-            if (failure === 'already_settled')
-                this.status = settledStatus(await this.requestOrNull(claim.id));
-            this.leaveDetail(false);
-            await this.rescan();
-            this.markDirty();
-            return;
-        }
-        this.submittingDir = undefined;
-        this.leaveDetail(false);
-        await this.rescan();
-        // A settled page whose row survives its own post-resolve rescan is the
-        // "row won't leave" defect. This records the truth at the exact moment the
-        // row should have dropped, so a live recurrence is diagnosable without a
-        // reproduction: did the request reach a terminal state, does the scan still
-        // list it, and was the claim left behind.
-        const stillListed = this.items.some((item) => item.dir === claim.dir);
-        emitEvent({
-            level: stillListed ? 'warn' : 'info',
-            event: 'inbox.page.resolved',
-            fields: {
-                ticket_id: claim.id,
-                request_settled: isSettled(await this.requestOrNull(claim.id)),
-                still_listed: stillListed,
-                claim_left_behind: existsSync(claimPath(claim.dir)),
-            },
-        });
-        this.markDirty();
-    }
-    /** Edit the active buffer while the host releases the terminal to $EDITOR. */
-    editActivePageInput() {
-        const buffer = this.adapter?.inputBuffer();
-        if (buffer === undefined)
-            return;
-        const resume = this.host.suspendForChild();
-        let result = { text: buffer };
-        try {
-            result = editBufferInEditor(buffer);
-        }
-        finally {
-            resume();
-            this.adapter?.setInputBuffer(result.text);
-            if (result.error !== undefined)
-                this.status = result.error;
-            this.markDirty();
-        }
-    }
-    leaveDetail(release = true) {
-        this.adapter?.close();
-        this.adapter = undefined;
-        this.selectedWatcher?.close();
-        this.selectedWatcher = undefined;
-        if (release && this.claim !== undefined)
-            releaseClaim(this.claim.dir, this.claim.token);
-        this.claim = undefined;
-        this.openRevision = undefined;
-        this.screen = 'list';
-    }
-    select(index) {
-        if (this.items.length === 0)
-            return;
-        this.selectedIndex = Math.max(0, Math.min(index, this.items.length - 1));
-        this.selectedDir = this.items[this.selectedIndex].dir;
-    }
-    detailSize() {
-        const layout = inboxLayout(this.cols, this.rows, this.screen);
-        return { cols: Math.max(1, layout.detailWidth - 2), rows: layout.height };
-    }
-    detailLines(width, rows) {
-        if (this.adapter !== undefined)
-            return this.adapter.render();
-        const selected = this.items[this.selectedIndex];
-        if (selected === undefined)
-            return this.passiveDetailLines(width, rows);
-        const focusHint = this.focusAvailable(selected.dir) ? `  ${DIM}g${RESET} chat` : '';
-        const sendHint = selected.kind === 'page' && selected.fastAction !== undefined
-            ? `  ${DIM}s${RESET} ${selected.fastAction.kind === 'acknowledge' ? 'acknowledge' : 'send recommended'}`
-            : '';
-        const footer = selected.kind === 'page'
-            ? [`  ${DIM}Enter${RESET} opens the full page  ${DIM}j/k${RESET} select${sendHint}  ${DIM}x${RESET} cancel`, `  ${DIM}Page:${RESET} c comment  u/d scroll${focusHint}  ${DIM}q${RESET} close`]
-            : [`  ${DIM}Enter${RESET} opens the full review  ${DIM}j/k${RESET} select  ${DIM}x${RESET} cancel`, ` ${focusHint}  ${DIM}q${RESET} close`];
-        // The hints hold the bottom of the pane rather than trailing the preview,
-        // so they stay in one place as the preview grows and shrinks.
-        const room = Math.max(0, rows - footer.length);
-        const preview = this.passiveDetailLines(width, room);
-        while (preview.length < room)
-            preview.push('');
-        return [...preview, ...footer.map((line) => clipLine(line, width))];
-    }
-    focusAvailable(_dir) {
-        return this.host.capabilities.canFocusNode;
-    }
-    /** Ask the host to bring the requesting node's viewer into view — the
-     *  conversation that raised this ask. */
-    async focusSelectedSource() {
-        const item = this.items[this.selectedIndex];
-        if (item === undefined || this.focusingSource)
-            return;
-        const requesterNodeId = item.source.nodeId;
-        if (requesterNodeId === undefined) {
-            this.status = 'This request was not raised by a canvas node';
-            this.markDirty();
-            return;
-        }
-        this.focusingSource = true;
-        try {
-            const focused = await this.host.focusNode(requesterNodeId);
-            if (focused)
-                this.close();
-            else {
-                this.status = 'Could not open that node’s viewer';
-                this.markDirty();
-            }
-        }
-        finally {
-            this.focusingSource = false;
-        }
-    }
-    /** What the selected page actually says. Rendering is synchronous and the
-     *  page is a round trip, so the projection is held and a miss schedules the
-     *  fetch, marking the frame dirty when it lands. A width change re-wraps the
-     *  held projection without another read. */
-    pagePreviewBody(item, width) {
-        const cached = this.preview;
-        if (cached !== undefined && cached.dir === item.dir) {
-            if (this.previewStale)
-                this.schedulePreview(item);
-            if (cached.width === width)
-                return cached.lines;
-            const lines = previewLines(cached.view, width);
-            this.preview = { ...cached, width, lines };
-            return lines;
-        }
-        this.schedulePreview(item);
-        // A failed read says so; an unfetched one is simply not there yet.
-        return this.previewFailed === item.dir ? [`${DIM}page could not be read${RESET}`] : [];
-    }
-    /** One in-flight preview read at a time. A revision that did not move keeps
-     *  the held projection, so activity on an unrelated ticket costs no re-wrap. */
-    schedulePreview(item) {
-        if (this.previewFetching === item.dir)
-            return;
-        this.previewFetching = item.dir;
-        this.previewStale = false;
-        void cliClient().getHumanInboxPage(item.inboxTicketId).then((page) => {
-            if (this.closed || this.previewFetching !== item.dir)
-                return;
-            this.previewFetching = undefined;
-            this.previewFailed = undefined;
-            if (this.preview?.dir === item.dir && this.preview.revision === page.revision)
-                return;
-            const view = pageViewFromDTO(page);
-            const width = this.preview?.width ?? inboxLayout(this.cols, this.rows, this.screen).detailWidth;
-            this.preview = { dir: item.dir, revision: page.revision, view, width, lines: previewLines(view, width) };
-            this.markDirty();
-        }, () => {
-            if (this.closed || this.previewFetching !== item.dir)
-                return;
-            this.previewFetching = undefined;
-            this.previewFailed = item.dir;
-            // Never leave the prior page's body standing under this row's title.
-            if (this.preview?.dir === item.dir)
-                this.preview = undefined;
-            this.markDirty();
-        });
-    }
-    /** The request record is the settlement authority: a settled page publishes
-     *  no file, so a claim would still succeed on its directory. An unreachable
-     *  daemon reads as "not known to be settled" — the settle attempt that
-     *  follows is the one that fails loudly. */
-    async requestOrNull(id) {
-        try {
-            return await cliClient().getHumanRequest(id);
-        }
-        catch {
-            return undefined;
-        }
-    }
-    /** The read-only preview beside the list. It shows the page's own content,
-     *  because `s` settles the selected ticket from here without ever opening
-     *  it — a reader must not answer something they were never shown. */
-    passiveDetailLines(width, rows) {
-        const selected = this.items[this.selectedIndex];
-        if (selected === undefined)
-            return [`  ${DIM}Select a pending interaction.${RESET}`];
-        const lines = [`  ${BOLD}${CYAN}${selected.title}${RESET}`, ''];
-        for (const rendered of renderMarkdown(selected.subtitle, Math.max(1, width - 2)))
-            lines.push(`  ${rendered}`);
-        const body = selected.kind === 'page' ? this.pagePreviewBody(selected, width) : [`${DIM}1 file to review${RESET}`];
-        if (body.length > 0) {
-            lines.push('');
-            const room = Math.max(0, rows - lines.length);
-            const shown = body.length <= room ? body : body.slice(0, Math.max(0, room - 1));
-            for (const line of shown)
-                lines.push(`  ${line}`);
-            if (shown.length < body.length)
-                lines.push(`  ${DIM}… +${body.length - shown.length} more lines${RESET}`);
-        }
-        return lines.map((line) => clipLine(line, width)).slice(0, Math.max(1, rows));
-    }
-    withStatus(lines) {
-        const status = this.cancelConfirmation === undefined
-            ? this.status
-            : `cancel “${this.cancelConfirmation.item.title}”?  y yes · n/Esc no`;
-        if (status === undefined || this.rows < 1)
-            return lines;
-        const next = [...lines];
-        while (next.length < this.rows)
-            next.push('');
-        next[this.rows - 1] = `${YELLOW}${status}${RESET}`;
-        return next;
-    }
-    markDirty() {
-        this.options.onDirty();
-    }
-    watchRoots() {
-        const unsubscribe = watchInboxActivity(this.options.onInboxActivity ?? (() => { void this.invalidate(); }));
-        this.watchers.push({ close: unsubscribe });
-    }
-    /** The request directory still carries the claim and progress files other
-     *  inboxes write. Its page content lives in the daemon-selected revision,
-     *  which `invalidate` re-reads over the API. */
-    watchSelected(dir) {
-        this.selectedWatcher?.close();
-        try {
-            this.selectedWatcher = watch(dir, () => { void this.invalidate(); });
-        }
-        catch {
-            this.selectedWatcher = undefined;
-        }
-    }
-}
-/** The inbox the daemon lists IS the inbox: visibility, ordering and row
- *  content all come from the one projection. */
-async function defaultScan() {
-    const { tickets } = await cliClient().listHumanInbox();
-    return tickets.map(inboxRowFromDTO).sort(byNewestFirst);
-}
-function previewLines(view, width) {
-    const display = view.manifest.dialect === 'html'
-        ? projectHtmlDocumentMarkdown(view.document)
-        : projectPageDisplayMarkdown(view.document, view.manifest);
-    return pageBodyLines(view.manifest, display, Math.min(Math.max(20, width - 4), 100), Math.max(20, width - 4));
-}
-/** A request the daemon no longer reports on is not known to be settled. */
-function isSettled(request) {
-    return request !== undefined && request.state !== 'pending';
-}
-/** Why a second settlement was refused, in the status line's own wording. */
-function settledStatus(request) {
-    if (request?.page === undefined)
-        return 'ticket was already resolved';
-    return settledStatusOf(request.page);
-}
+var A=Object.defineProperty;var c=(d,e)=>A(d,"name",{value:e,configurable:!0});import{existsSync as C,watch as F}from"node:fs";import{visibleWidth as P}from"@earendil-works/pi-tui";import{renderMarkdown as M}from"../../core/termrender/termrender.js";import{BOLD as R,CYAN as W,DIM as h,GRAY as q,RESET as a,YELLOW as k,clipLine as p}from"./tui/ansi.js";import{buildInboxLines as L,recommendedLabel as N}from"./tui.js";import{inboxLayout as g}from"./layout.js";import{resolvePageComponents as O}from"../../core/config.js";import{watchInboxActivity as E}from"../../core/human/root.js";import{claimTicket as b,heartbeatClaim as T,releaseClaim as u}from"../../core/human/claim.js";import{claimPath as B,clearProgress as H}from"../../core/human/convention.js";import{emitEvent as _}from"../../core/events/emit.js";import{cliClient as f}from"../../commands/api-client.js";import{projectPageDisplayMarkdown as z}from"../../core/human/page-markdown.js";import{projectHtmlDocumentMarkdown as j}from"../../core/human/page-html-markdown.js";import{pageBodyLines as K}from"./tui/page-body.js";import{byNewestFirst as Y,inboxRowFromDTO as G,pageViewFromDTO as y,settledStatusOf as x}from"./dto-adapt.js";import{PageAdapter as V}from"./page-adapter.js";import{ReviewAdapter as X}from"./review-adapter.js";import{createReviewClient as J}from"./review/review-client.js";import{editBufferInEditor as Q}from"./review/roundtrip.js";import{daemonErrorMessage as m,dismissTicketViaDaemon as U,resolveFailureKind as $,resolveTicketPage as I}from"./resolve.js";class be{static{c(this,"InboxController")}options;host;scan;items=[];selectedDir;selectedIndex=0;screen="list";adapter;reviewAdapter;focusingSource=!1;claim;submittingDir;cancelConfirmation;cols;rows;status;watchers=[];selectedWatcher;heartbeat;started=!1;closed=!1;preview;previewFailed;previewFetching;previewStale=!1;openRevision;constructor(e){this.options=e,this.host=e.host,this.scan=e.scan??Z,this.cols=e.cols??80,this.rows=e.rows??24,this.selectedDir=e.initialSelection,this.rescan()}snapshot(){return{items:[...this.items],selectedDir:this.selectedDir,screen:this.screen,inputBuffer:this.adapter?.inputBuffer()}}async rescan(){const e=this.selectedDir,t=this.selectedIndex,i=this.claim;try{this.items=await this.scan()}catch(r){if(this.closed)return;this.status=m(r),this.markDirty();return}if(this.closed)return;const s=e===void 0?-1:this.items.findIndex(r=>r.dir===e);if(s>=0){this.selectedIndex=s,this.selectedDir=e;return}if(this.adapter!==void 0&&e!==void 0&&i!==void 0){const r=(await this.requestOrNull(i.id))?.state==="canceled";if(this.closed)return;r&&H(e),e!==this.submittingDir&&(this.status=r?"canceled by requester":"ticket resolved elsewhere"),this.leaveDetail(e!==this.submittingDir)}if(this.items.length===0){this.selectedIndex=0,this.selectedDir=void 0;return}this.selectedIndex=Math.min(t,this.items.length-1),this.selectedDir=this.items[this.selectedIndex].dir}start(){this.started||this.closed||(this.started=!0,this.watchRoots(),this.heartbeat=setInterval(()=>{this.claim!==void 0&&T(this.claim.dir,this.claim.token)},1e4))}async invalidate(){if(this.previewStale=!0,await this.rescan(),!this.closed){if(this.adapter!==void 0&&this.claim!==void 0){await this.reloadSelectedPage();return}this.markDirty()}}resize(e,t){this.cols=e,this.rows=t,this.adapter?.resize(this.detailSize().cols,this.detailSize().rows),this.markDirty()}render(){const e=g(this.cols,this.rows,this.screen);if(e.mode==="minimum")return[`${k}Resize terminal to at least 60\xD718 to use inbox.${a}`];const t=L(this.items,e.listWidth,this.selectedIndex,e.height),i=this.detailLines(e.detailWidth,e.height);if(e.mode==="list")return this.withStatus(t);if(e.mode==="detail")return this.withStatus(i);const s=[],r=`${q}\u2502${a}`;for(let n=0;n<e.height;n++){const o=p(t[n]??"",e.listWidth),l=p(i[n]??"",e.detailWidth),v=" ".repeat(Math.max(0,e.listWidth-P(o)));s.push(`${o}${v}${r}${l}`)}return this.withStatus(s)}handleKey(e,t){if(t.ctrl&&e==="c"){this.close();return}if(this.screen==="detail"&&this.adapter!==void 0){if((e==="g"||e==="G")&&this.adapter.canAcceptHostKeys()){this.focusSelectedSource();return}this.adapter.handleKey(e,t),this.markDirty();return}if(this.cancelConfirmation!==void 0){if(e==="y"||e==="Y"){const i=this.cancelConfirmation.item;this.cancelConfirmation=void 0,this.status="canceling\u2026",this.cancelFromInbox(i)}else(e==="n"||e==="N"||t.escape)&&(this.cancelConfirmation=void 0,this.status=void 0);this.markDirty();return}if(e==="x"||e==="X"){const i=this.items[this.selectedIndex];i!==void 0&&(this.cancelConfirmation={item:i},this.status=void 0),this.markDirty();return}if(e==="s"||e==="S"){this.sendFastAction(),this.markDirty();return}if(t.escape||e==="q"){this.close();return}e==="j"||t.downArrow?this.select(this.selectedIndex+1):e==="k"||t.upArrow?this.select(this.selectedIndex-1):e==="g"||e==="G"?this.focusSelectedSource():(t.return||e==="a")&&this.activate(),this.markDirty()}async sendFastAction(){const e=this.items[this.selectedIndex];if(e===void 0)return;if(e.kind!=="page"||e.fastAction===void 0){this.status="no recommended answer on this ticket \u2014 Enter opens it";return}const t=await this.requestOrNull(e.id);if(D(t)){this.status=w(t),await this.rescan();return}const i=b(e.dir);if(i===null){this.status="ticket is being edited by another inbox";return}const s=e.fastAction.kind==="acknowledge"?"acknowledged":`sent: ${N(e)??"recommended answer"}`;this.submittingDir=e.dir;try{await I(e.id,e.fastAction.responses),this.status=s}catch(r){this.status=$(r)==="already_settled"?w(await this.requestOrNull(e.id)):m(r)}finally{u(e.dir,i.token),this.submittingDir=void 0,await this.rescan(),this.markDirty()}}async cancelFromInbox(e){this.submittingDir=e.dir;try{e.kind==="review"?await J().cancel(e.id,"Canceled from the inbox."):await U(e.id,{reason:"Canceled from the inbox.",actor:"human"}),this.status="canceled"}catch(t){this.status=m(t)}finally{this.submittingDir=void 0,await this.rescan(),this.markDirty()}}async activate(){const e=this.items[this.selectedIndex];if(e===void 0)return;if(e.kind==="review"){await this.activateReview(e);return}const t=await this.requestOrNull(e.id);if(this.closed)return;if(D(t)){this.status=w(t),await this.rescan();return}const i=b(e.dir);if(i===null){this.status="ticket is being edited by another inbox";return}let s,r;try{const n=await f().getHumanInboxPage(e.inboxTicketId);if(n.state==="resolved"||n.state==="canceled"){u(e.dir,i.token),this.status=x(n),await this.rescan();return}s=y(n),r=n.revision}catch{u(e.dir,i.token),this.status="page could not be read",await this.invalidate();return}if(this.closed||this.claim!==void 0||this.adapter!==void 0){u(e.dir,i.token);return}this.claim={dir:e.dir,id:e.id,ticketId:e.inboxTicketId,token:i.token},this.screen="detail",this.adapter=new V({ticketId:e.inboxTicketId,page:s,productKinds:O(),cols:this.detailSize().cols,rows:this.detailSize().rows,onDirty:c(()=>this.markDirty(),"onDirty"),onEditorRequest:c(()=>this.editActivePageInput(),"onEditorRequest"),onBack:c(()=>{this.leaveDetail(),this.markDirty()},"onBack"),onComplete:c(n=>{this.complete(n)},"onComplete")}),this.openRevision=r,this.watchSelected(e.dir),this.markDirty()}async activateReview(e){this.reviewAdapter=new X({reviewId:e.id,host:this.host});try{await this.reviewAdapter.start()}catch(t){this.status=m(t)}finally{this.reviewAdapter=void 0,await this.rescan(),this.markDirty()}}selectDir(e){const t=this.items.findIndex(i=>i.dir===e);t>=0&&(this.select(t),this.markDirty())}async reloadSelectedPage(){const e=this.claim;if(this.adapter===void 0||e===void 0){this.markDirty();return}try{const t=await f().getHumanInboxPage(e.ticketId);if(this.closed||this.claim!==e||this.adapter===void 0)return;t.revision!==this.openRevision&&(this.openRevision=t.revision,this.adapter.reload(y(t)))}catch{this.status="page could not be read"}this.markDirty()}close(){if(!this.closed){this.closed=!0,this.started=!1,this.heartbeat!==void 0&&clearInterval(this.heartbeat),this.heartbeat=void 0,this.reviewAdapter?.stop(),this.leaveDetail(this.claim?.dir!==this.submittingDir);for(const e of this.watchers)e.close();this.watchers=[],this.selectedWatcher?.close(),this.selectedWatcher=void 0,this.options.onClosed()}}async complete(e){const t=this.claim;if(t===void 0)return;this.submittingDir=t.dir;try{await I(t.id,e)}catch(s){this.submittingDir=void 0,this.status=m(s);const r=$(s);if(r==="unreachable"||r==="other"){this.markDirty();return}r==="already_settled"&&(this.status=w(await this.requestOrNull(t.id))),this.leaveDetail(!1),await this.rescan(),this.markDirty();return}this.submittingDir=void 0,this.leaveDetail(!1),await this.rescan();const i=this.items.some(s=>s.dir===t.dir);_({level:i?"warn":"info",event:"inbox.page.resolved",fields:{ticket_id:t.id,request_settled:D(await this.requestOrNull(t.id)),still_listed:i,claim_left_behind:C(B(t.dir))}}),this.markDirty()}editActivePageInput(){const e=this.adapter?.inputBuffer();if(e===void 0)return;const t=this.host.suspendForChild();let i={text:e};try{i=Q(e)}finally{t(),this.adapter?.setInputBuffer(i.text),i.error!==void 0&&(this.status=i.error),this.markDirty()}}leaveDetail(e=!0){this.adapter?.close(),this.adapter=void 0,this.selectedWatcher?.close(),this.selectedWatcher=void 0,e&&this.claim!==void 0&&u(this.claim.dir,this.claim.token),this.claim=void 0,this.openRevision=void 0,this.screen="list"}select(e){this.items.length!==0&&(this.selectedIndex=Math.max(0,Math.min(e,this.items.length-1)),this.selectedDir=this.items[this.selectedIndex].dir)}detailSize(){const e=g(this.cols,this.rows,this.screen);return{cols:Math.max(1,e.detailWidth-2),rows:e.height}}detailLines(e,t){if(this.adapter!==void 0)return this.adapter.render();const i=this.items[this.selectedIndex];if(i===void 0)return this.passiveDetailLines(e,t);const s=this.focusAvailable(i.dir)?`  ${h}g${a} chat`:"",r=i.kind==="page"&&i.fastAction!==void 0?`  ${h}s${a} ${i.fastAction.kind==="acknowledge"?"acknowledge":"send recommended"}`:"",n=i.kind==="page"?[`  ${h}Enter${a} opens the full page  ${h}j/k${a} select${r}  ${h}x${a} cancel`,`  ${h}Page:${a} c comment  u/d scroll${s}  ${h}q${a} close`]:[`  ${h}Enter${a} opens the full review  ${h}j/k${a} select  ${h}x${a} cancel`,` ${s}  ${h}q${a} close`],o=Math.max(0,t-n.length),l=this.passiveDetailLines(e,o);for(;l.length<o;)l.push("");return[...l,...n.map(v=>p(v,e))]}focusAvailable(e){return this.host.capabilities.canFocusNode}async focusSelectedSource(){const e=this.items[this.selectedIndex];if(e===void 0||this.focusingSource)return;const t=e.source.nodeId;if(t===void 0){this.status="This request was not raised by a canvas node",this.markDirty();return}this.focusingSource=!0;try{await this.host.focusNode(t)?this.close():(this.status="Could not open that node\u2019s viewer",this.markDirty())}finally{this.focusingSource=!1}}pagePreviewBody(e,t){const i=this.preview;if(i!==void 0&&i.dir===e.dir){if(this.previewStale&&this.schedulePreview(e),i.width===t)return i.lines;const s=S(i.view,t);return this.preview={...i,width:t,lines:s},s}return this.schedulePreview(e),this.previewFailed===e.dir?[`${h}page could not be read${a}`]:[]}schedulePreview(e){this.previewFetching!==e.dir&&(this.previewFetching=e.dir,this.previewStale=!1,f().getHumanInboxPage(e.inboxTicketId).then(t=>{if(this.closed||this.previewFetching!==e.dir||(this.previewFetching=void 0,this.previewFailed=void 0,this.preview?.dir===e.dir&&this.preview.revision===t.revision))return;const i=y(t),s=this.preview?.width??g(this.cols,this.rows,this.screen).detailWidth;this.preview={dir:e.dir,revision:t.revision,view:i,width:s,lines:S(i,s)},this.markDirty()},()=>{this.closed||this.previewFetching!==e.dir||(this.previewFetching=void 0,this.previewFailed=e.dir,this.preview?.dir===e.dir&&(this.preview=void 0),this.markDirty())}))}async requestOrNull(e){try{return await f().getHumanRequest(e)}catch{return}}passiveDetailLines(e,t){const i=this.items[this.selectedIndex];if(i===void 0)return[`  ${h}Select a pending interaction.${a}`];const s=[`  ${R}${W}${i.title}${a}`,""];for(const n of M(i.subtitle,Math.max(1,e-2)))s.push(`  ${n}`);const r=i.kind==="page"?this.pagePreviewBody(i,e):[`${h}1 file to review${a}`];if(r.length>0){s.push("");const n=Math.max(0,t-s.length),o=r.length<=n?r:r.slice(0,Math.max(0,n-1));for(const l of o)s.push(`  ${l}`);o.length<r.length&&s.push(`  ${h}\u2026 +${r.length-o.length} more lines${a}`)}return s.map(n=>p(n,e)).slice(0,Math.max(1,t))}withStatus(e){const t=this.cancelConfirmation===void 0?this.status:`cancel \u201C${this.cancelConfirmation.item.title}\u201D?  y yes \xB7 n/Esc no`;if(t===void 0||this.rows<1)return e;const i=[...e];for(;i.length<this.rows;)i.push("");return i[this.rows-1]=`${k}${t}${a}`,i}markDirty(){this.options.onDirty()}watchRoots(){const e=E(this.options.onInboxActivity??(()=>{this.invalidate()}));this.watchers.push({close:e})}watchSelected(e){this.selectedWatcher?.close();try{this.selectedWatcher=F(e,()=>{this.invalidate()})}catch{this.selectedWatcher=void 0}}}async function Z(){const{tickets:d}=await f().listHumanInbox();return d.map(G).sort(Y)}c(Z,"defaultScan");function S(d,e){const t=d.manifest.dialect==="html"?j(d.document):z(d.document,d.manifest);return K(d.manifest,t,Math.min(Math.max(20,e-4),100),Math.max(20,e-4))}c(S,"previewLines");function D(d){return d!==void 0&&d.state!=="pending"}c(D,"isSettled");function w(d){return d?.page===void 0?"ticket was already resolved":x(d.page)}c(w,"settledStatus");export{be as InboxController};