@fitchmultz/pi-subagents 0.49.1 → 0.50.0

package/dist/tui/agent-conversation.js

@@ -1,444 +0,0 @@
-import { hasText, errorText } from "./text-values.js";
-import { conversationChoices, conversationHeading, conversationShortcut, primaryConversationAction, primaryConversationHint, } from "./conversation-menu.js";
-import { ConversationViewport } from "./conversation-viewport.js";
-import { ConversationHistory } from "./conversation-history.js";
-import { ConversationDetails } from "./conversation-details.js";
-import { ConversationSelection } from "./conversation-selection.js";
-import { HistoryCards } from "./history-cards.js";
-import { getSelectListTheme, } from "@earendil-works/pi-coding-agent";
-import { Container, Editor, SelectList, matchesKey, } from "@earendil-works/pi-tui";
-import { conversationControls, conversationFrame } from "./conversation-frame.js";
-import { editorViewport } from "./editor-viewport.js";
-/** Native ScrollView owns follow/scroll state; overlays only need a bounded render adapter. */
-export class AgentConversation extends Container {
-    details;
-    history;
-    cards;
-    editor;
-    scroll;
-    viewport;
-    editorViewport;
-    editorHeight = Infinity;
-    editorFocus = true;
-    hasFocus = false;
-    closed = false;
-    beforeInput = "";
-    selection;
-    menu;
-    initialVisit;
-    keys;
-    tui;
-    theme;
-    controller;
-    key;
-    done;
-    constructor(tui, theme, options) {
-        super();
-        const { controller, key, done, keys } = options;
-        this.tui = tui;
-        this.theme = theme;
-        this.controller = controller;
-        this.key = key;
-        this.done = done;
-        this.keys = keys;
-        this.details = this.createDetails();
-        this.initialVisit = { anchor: this.visit.anchor, readThrough: this.visit.readThrough };
-        this.history = new ConversationHistory(tui, controller, key, {
-            initialPosition: () => this.viewport.initialPosition,
-            initialVisit: () => this.initialVisit,
-            readSequence: (sequence) => {
-                this.viewport.readSequence = sequence;
-            },
-            clearCards: () => this.cards.clear(),
-            refresh: () => this.refresh(),
-        });
-        this.cards = new HistoryCards(tui, theme, () => this.task?.child.launch?.cwd ?? this.task?.run.cwd ?? process.cwd());
-        this.editor = new Editor(tui, { borderColor: (text) => theme.fg("accent", text), selectList: getSelectListTheme() }, { paddingX: 0 });
-        this.bindEditor();
-        this.editorViewport = editorViewport(this.editor, () => this.editorHeight);
-        this.viewport = new ConversationViewport(tui, this.cards, {
-            task: () => this.task,
-            visit: () => this.visit,
-            loading: () => this.history.loadingPage,
-            detail: () => Boolean(this.details.detail),
-            initialVisit: this.initialVisit,
-            content: {
-                render: (width) => this.cards.render(width, this.history.items(this.details.detail), {
-                    selectedId: this.selection.id,
-                    editorFocus: this.editorFocus,
-                    detail: Boolean(this.details.detail),
-                    toolsExpanded: this.selection.toolsExpanded,
-                    toolExpansion: this.selection.toolExpansion,
-                }),
-                invalidate() {
-                    /* HistoryCards caches are invalidated by the conversation. */
-                },
-            },
-        }, (event) => this.historyMouse(event));
-        this.scroll = this.viewport.scroll;
-        this.selection = new ConversationSelection(this.cards, this.scroll);
-        this.run(this.history.loadPage({}, this.visit.anchor?.id ?? this.visit.readThrough));
-    }
-    createDetails() {
-        return new ConversationDetails(this.tui, {
-            task: () => this.task,
-            visit: () => this.visit,
-            selected: () => this.selection.selected(this.details.detail),
-            following: () => this.scroll.isFollowingEnd,
-            anchor: () => this.viewport.anchor(),
-            compose: (value) => {
-                this.editorFocus = value;
-                this.focused = this.hasFocus;
-            },
-            closeMenu: () => {
-                this.menu = undefined;
-            },
-            restore: (anchor) => {
-                this.viewport.restoreAnchor = anchor;
-            },
-            toStart: () => this.scroll.scrollToStart(),
-            toEnd: () => this.scroll.scrollToEnd(),
-            changed: () => this.controller.changed(),
-            back: () => this.act("back"),
-            changes: () => this.controller.changes(this.key),
-        });
-    }
-    bindEditor() {
-        this.editor.setText(this.visit.draft);
-        this.editor.onChange = () => {
-            if (!this.closed) {
-                this.visit.draft = this.editor.getExpandedText();
-                this.controller.changed();
-            }
-        };
-        this.editor.onSubmit = (text) => {
-            this.editor.setText(this.beforeInput);
-            if (!this.details.loadingDetail) {
-                this.run(this.controller.send(this.key, text));
-            }
-        };
-    }
-    get visit() {
-        return this.controller.visit(this.key);
-    }
-    get task() {
-        return this.controller.task(this.key);
-    }
-    get focused() {
-        return this.hasFocus;
-    }
-    set focused(value) {
-        this.hasFocus = value;
-        this.editor.focused = value && this.editorFocus && !this.details.detail && !this.menu;
-    }
-    refresh() {
-        if (this.closed) {
-            return;
-        }
-        if (this.details.detail?.id === "assignment" && this.task) {
-            this.details.detail = this.history.assignment();
-        }
-        if (!this.viewport.initialPosition && !this.scroll.isFollowingEnd) {
-            this.viewport.restoreAnchor = this.viewport.anchor();
-        }
-        this.refreshFollowing();
-        this.tui.requestRender();
-    }
-    refreshFollowing() {
-        if (this.history.latestPage &&
-            this.scroll.isFollowingEnd &&
-            !this.details.detail &&
-            !hasText(this.history.pageError)) {
-            this.history.refreshPending = this.history.loadingPage;
-            if (!this.history.loadingPage) {
-                this.run(this.history.loadPage());
-            }
-        }
-    }
-    syncDraft() {
-        if (!this.closed && this.editor.getExpandedText() !== this.visit.draft) {
-            this.editor.setText(this.visit.draft);
-        }
-    }
-    run(operation) {
-        operation.catch((error) => {
-            if (!this.closed) {
-                this.visit.notice = errorText(error);
-                this.tui.requestRender();
-            }
-        });
-    }
-    entrance() {
-        if (this.details.detail) {
-            return "Agents";
-        }
-        if (this.history.loadingPage && !this.task?.page) {
-            return "Loading conversation…";
-        }
-        return this.history.pageError !== undefined ? "History unavailable · F5 retry" : "Agents";
-    }
-    render(width) {
-        const task = this.task, height = this.controller.availableHeight(this.tui);
-        const primary = primaryConversationAction(task, this.editorFocus);
-        const footer = conversationControls({
-            menu: Boolean(this.menu),
-            detail: Boolean(this.details.detail),
-            compact: height < 16,
-            width,
-            primary,
-            actionHint: primaryConversationHint(primary, width, this.details.loadingDetail && !this.details.detail, task),
-            act: (action) => this.act(action),
-        }, this.theme);
-        const entrance = this.entrance();
-        this.editorHeight = Infinity;
-        const frame = conversationFrame({
-            width,
-            height,
-            ...conversationHeading(task, {
-                entrance,
-                detail: this.details.detail !== undefined,
-                following: this.scroll.isFollowingEnd,
-                busy: this.controller.isBusy(this.key),
-            }),
-            menu: this.menu,
-            detail: Boolean(this.details.detail),
-            footer,
-            viewport: this.viewport,
-            editorViewport: this.editorViewport,
-            editorRows: this.editor.render(Math.max(1, width - 2)).length,
-            notice: this.visit.notice,
-            quoteTitle: this.visit.quote?.title,
-            act: (action) => this.act(action),
-        }, this.theme);
-        this.editorHeight = frame.editorHeight;
-        this.viewport.height = frame.historyHeight;
-        this.clear();
-        this.addChild(frame.component);
-        this.focused = this.hasFocus;
-        return super.render(width);
-    }
-    invalidate() {
-        this.cards.clear();
-        super.invalidate();
-    }
-    handleMouse(event) {
-        const result = super.handleMouse(event);
-        if (result?.target.component === this.editorViewport) {
-            this.editorFocus = true;
-            this.focused = this.hasFocus;
-        }
-        return result;
-    }
-    historyMouse(event) {
-        if (event.type === "wheel") {
-            this.scroll.scrollBy(event.wheelDelta ?? 0);
-            this.viewport.restoreAnchor = this.viewport.anchor();
-            return { handled: true };
-        }
-        const anchor = this.viewport.anchor();
-        const result = this.selection.mouse(event, this.details.detail !== undefined);
-        if (result?.focus === true) {
-            this.viewport.restoreAnchor = anchor;
-            this.editorFocus = false;
-        }
-        return result;
-    }
-    select(delta) {
-        if (this.selection.select(delta, this.viewport.height)) {
-            this.viewport.restoreAnchor = this.viewport.anchor();
-        }
-    }
-    actions() {
-        const choices = conversationChoices(this.task, {
-            expanded: this.selection.toolsExpanded,
-            pinned: this.controller.pinned === this.key,
-            quote: this.visit.quote,
-        });
-        this.menu = new SelectList(choices, Math.max(1, this.controller.availableHeight(this.tui) - 7), getSelectListTheme());
-        this.menu.onSelect = (item) => {
-            this.menu = undefined;
-            this.act(item.value);
-        };
-        this.menu.onCancel = () => {
-            this.menu = undefined;
-        };
-    }
-    back() {
-        if (this.menu) {
-            this.menu.onCancel?.();
-            return;
-        }
-        if (!this.details.close()) {
-            this.finish();
-        }
-    }
-    choose() {
-        const menu = this.menu, item = menu?.getSelectedItem();
-        if (menu && item) {
-            menu.onSelect?.(item);
-        }
-    }
-    focusEditor() {
-        if (this.details.detail) {
-            return;
-        }
-        this.editorFocus = !this.editorFocus;
-        if (!this.editorFocus) {
-            this.select(0);
-        }
-    }
-    page(direction) {
-        const page = this.task?.page;
-        if (direction === "earlier" && page?.previousBefore !== undefined) {
-            this.run(this.history.loadPage({ before: page.previousBefore }));
-        }
-        else if (direction === "later" && !this.history.latestPage && page?.nextAfter !== undefined) {
-            this.run(this.history.loadPage({ after: page.nextAfter }));
-        }
-        this.cards.clear();
-        this.selection.id = undefined;
-        this.scroll.scrollToEnd();
-    }
-    async retry() {
-        await this.controller.retry(this.key);
-        if (!this.closed) {
-            await this.history.loadPage();
-        }
-    }
-    latest() {
-        this.viewport.initialPosition = false;
-        this.details.detailRequest++;
-        this.details.loadingDetail = false;
-        this.details.detail = undefined;
-        this.cards.clear();
-        this.run(this.history.loadPage());
-        this.viewport.restoreAnchor = undefined;
-        this.details.conversationAnchor = undefined;
-        this.scroll.scrollToEnd();
-        this.selection.id = this.editorFocus ? undefined : this.history.items().at(-1)?.id;
-    }
-    expand() {
-        if (!this.scroll.isFollowingEnd) {
-            this.viewport.restoreAnchor = this.viewport.anchor();
-        }
-        this.selection.expand();
-    }
-    submit(continuing) {
-        if (this.details.loadingDetail) {
-            return;
-        }
-        const text = this.editor.getExpandedText();
-        this.run(this.controller.send(this.key, continuing ? text : text.trim(), continuing));
-    }
-    commands = {
-        back: () => this.back(),
-        choose: () => this.choose(),
-        actions: () => this.actions(),
-        focus: () => this.focusEditor(),
-        send: () => this.submit(false),
-        continue: () => this.submit(true),
-        reply: () => this.run(this.details.reply()),
-        details: () => this.run(this.details.inspectSelected()),
-        earlier: () => this.page("earlier"),
-        later: () => this.page("later"),
-        retry: () => this.run(this.retry()),
-        assignment: () => {
-            if (this.task) {
-                this.run(this.details.inspect(this.history.assignment()));
-            }
-        },
-        expand: () => this.expand(),
-        changes: () => this.run(this.details.changes()),
-        latest: () => this.latest(),
-        pin: () => this.controller.pin(this.controller.pinned === this.key ? undefined : this.key),
-        unquote: () => this.details.unquote(),
-        stop: () => this.run(this.controller.stop(this.key)),
-        picker: () => this.finish("picker"),
-        peers: () => this.finish("peers"),
-    };
-    act(action) {
-        if (this.closed) {
-            return;
-        }
-        this.commands[action]?.();
-        this.focused = this.hasFocus;
-        this.tui.requestRender();
-    }
-    shortcut(data) {
-        if (this.keys?.matches(data, "app.tools.expand") ?? matchesKey(data, "ctrl+o")) {
-            return "expand";
-        }
-        if (matchesKey(data, "alt+d") && (!this.editorFocus || this.details.detail)) {
-            return "details";
-        }
-        if (matchesKey(data, "tab") && !this.details.detail) {
-            return "focus";
-        }
-        return conversationShortcut(data);
-    }
-    navigate(data) {
-        if (matchesKey(data, "up")) {
-            this.select(-1);
-        }
-        else if (matchesKey(data, "down")) {
-            this.select(1);
-        }
-        else if (matchesKey(data, "home")) {
-            this.scroll.scrollToStart();
-            this.viewport.restoreAnchor = this.viewport.anchor();
-        }
-        else if (matchesKey(data, "end")) {
-            this.act("latest");
-        }
-        else if (matchesKey(data, "enter")) {
-            this.act("details");
-        }
-    }
-    input(data) {
-        const action = this.shortcut(data);
-        if (action !== undefined) {
-            this.act(action);
-            return;
-        }
-        if (matchesKey(data, "pageUp") || matchesKey(data, "pageDown")) {
-            this.scroll.scrollBy(matchesKey(data, "pageUp") ? -this.viewport.height : this.viewport.height);
-            this.viewport.restoreAnchor = this.viewport.anchor();
-        }
-        else if (!this.editorFocus || this.details.detail) {
-            this.navigate(data);
-        }
-        else {
-            this.beforeInput = this.editor.getExpandedText();
-            this.editor.handleInput(data);
-        }
-    }
-    handleInput(data) {
-        if (this.closed) {
-            return;
-        }
-        if (matchesKey(data, this.controller.shortcut)) {
-            this.finish();
-            return;
-        }
-        if (this.menu) {
-            this.menu.handleInput(data);
-        }
-        else {
-            this.input(data);
-        }
-        this.focused = this.hasFocus;
-        this.tui.requestRender();
-    }
-    finish(key) {
-        this.controller.changed();
-        this.done(key);
-    }
-    dispose() {
-        this.closed = true;
-        this.details.dispose();
-        this.history.dispose();
-        this.editor.onChange = undefined;
-        this.editor.onSubmit = undefined;
-        this.cards.clear();
-    }
-}

package/dist/tui/agent-dock.js

@@ -1,171 +0,0 @@
-import { hasText, nonemptyText } from "./text-values.js";
-import { rawKeyHint } from "@earendil-works/pi-coding-agent";
-import { MouseRegion, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
-import { getSingleResultOutput } from "../shared/utils.js";
-import { readableText } from "./agent-history.js";
-import { buildWidgetLines } from "./render.js";
-import { UNAVAILABLE_ASSIGNMENT, activity, short, taskSummary, runningIndicator, } from "./view-model.js";
-const STYLES = {
-    running: { color: "success", symbol: "●" },
-    waiting: { color: "dim", symbol: "◷" },
-    "needs action": { color: "warning", symbol: "!" },
-};
-function dockState(task) {
-    if (task.child.state === "blocked" || task.question?.state === "awaiting_input") {
-        return "needs action";
-    }
-    return task.child.activity?.status === "pending" || task.question?.state === "answer_pending"
-        ? "waiting"
-        : "running";
-}
-function pinnedPreview(task) {
-    if (task.child.identityUnavailable === true) {
-        return UNAVAILABLE_ASSIGNMENT;
-    }
-    if (task.child.state === "live") {
-        return activity(task);
-    }
-    const result = task.child.result;
-    return ((result && nonemptyText(getSingleResultOutput(result))) ??
-        nonemptyText(task.history.findLast((item) => item.kind === "assistant")?.text) ??
-        activity(task));
-}
-export class AgentDock {
-    hits = [];
-    component;
-    tui;
-    theme;
-    source;
-    constructor(tui, theme, source) {
-        this.tui = tui;
-        this.theme = theme;
-        this.source = source;
-        this.component = new MouseRegion({
-            render: (width) => this.render(width),
-            invalidate() {
-                /* Current source/theme are read on every render. */
-            },
-        }, (event) => {
-            if (tui.mode !== "fullscreen" || event.button !== "left" || !source.live()) {
-                return;
-            }
-            const hit = this.hits.find((candidate) => candidate.row === event.y && event.x >= candidate.start && event.x < candidate.end);
-            if (!hit) {
-                return;
-            }
-            if (event.type === "press") {
-                return { handled: true };
-            }
-            if (event.type !== "click") {
-                return;
-            }
-            if (hit.unpin === true) {
-                source.unpin();
-            }
-            else {
-                source.open(hit.key);
-            }
-            return { handled: true };
-        });
-    }
-    empty(width) {
-        const failed = hasText(this.source.error());
-        if (!failed &&
-            !this.source.loading() &&
-            this.source.page()?.freshness.state !== "catching-up") {
-            return [];
-        }
-        const label = failed
-            ? "Agents history unavailable · /agents to retry"
-            : "Agents · loading history…";
-        this.hits.push({ start: 0, end: width, row: 0 });
-        return [truncateToWidth(this.theme.fg(failed ? "warning" : "dim", label), width)];
-    }
-    heading(active, width) {
-        const running = active.filter((row) => row.state === "running").length;
-        const waiting = active.filter((row) => row.state === "waiting").length;
-        const needsAction = active.filter((row) => row.state === "needs action").length;
-        const counts = `${running} running${waiting > 0 ? ` · ${waiting} waiting` : ""}${needsAction > 0 ? ` · ${needsAction} needs action` : ""}`;
-        const hint = readableText(rawKeyHint(this.source.shortcut, "")).trim();
-        const entrance = `${this.theme.fg("accent", this.theme.bold("Agents"))} · ${this.theme.fg(running > 0 ? "success" : "muted", counts)} ${this.theme.fg("dim", `[${hint}]`)}`;
-        this.hits.push({ start: 0, end: Math.min(width, visibleWidth(entrance)), row: 0 });
-        return truncateToWidth(entrance, width);
-    }
-    pulseFrom(rows, width) {
-        if (this.tui.mode !== "regular") {
-            return 0;
-        }
-        // MainScreen repaints all scrollback if an offscreen row's ANSI changes.
-        return (rows +
-            this.source.below().reduce((height, child) => height + child.render(width).length, 0) -
-            this.tui.terminal.rows);
-    }
-    row(row, width, pulse) {
-        const { task, state } = row, { color, symbol } = STYLES[state];
-        const indicator = state === "running" && pulse ? runningIndicator(this.theme) : this.theme.fg(color, symbol);
-        const { status, badge } = taskSummary(task);
-        const statusText = status === "working" ? "" : this.theme.fg(color, ` · ${status}`);
-        const available = width - visibleWidth(statusText + badge) - 4;
-        const modelWidth = available - Math.min(30, visibleWidth(task.label)) - 3;
-        const model = modelWidth >= 16 ? ` · ${short(task.model.summary, modelWidth)}` : "";
-        const label = short(task.label, Math.max(1, available - visibleWidth(model)));
-        return truncateToWidth(`  ${indicator} ${this.theme.bold(label)}${statusText}${this.theme.fg("accent", badge)}${this.theme.fg("dim", model)}`, width);
-    }
-    more(count, width, row) {
-        if (count <= 0) {
-            return;
-        }
-        const more = `  +${count} more · /agents`, line = truncateToWidth(more, width, "...");
-        this.hits.push({
-            start: 2,
-            end: visibleWidth(line) - (visibleWidth(more) > width ? 3 : 0),
-            row,
-        });
-        return this.theme.fg("dim", line);
-    }
-    pin(task, width, row) {
-        if (!task) {
-            return;
-        }
-        const unpin = "[Unpin] ";
-        const text = this.theme.fg("dim", truncateToWidth(`${unpin}Pinned · ${task.child.state === "completed" ? "finished · " : ""}${short(task.label, 30)}: ${short(pinnedPreview(task), width)}`, width));
-        this.hits.push({ start: 0, end: unpin.length, row, unpin: true }, { start: unpin.length, end: width, row, key: task.key });
-        return text;
-    }
-    render(width) {
-        this.hits = [];
-        const active = this.source
-            .tasks()
-            .filter((task) => task.child.state === "live" ||
-            task.child.state === "blocked" ||
-            task.question !== undefined)
-            .map((task) => ({ task, state: dockState(task) }));
-        if (active.length === 0) {
-            return this.empty(width);
-        }
-        const lines = [this.heading(active, width)];
-        const visible = active.slice(0, Math.max(1, Math.min(4, Math.floor(this.tui.terminal.rows / 5))));
-        const pinned = this.source.pinned();
-        const details = this.source.expanded()
-            ? buildWidgetLines([...this.source.jobs()], this.theme, width, true)
-            : [];
-        const pulse = this.pulseFrom(visible.length +
-            details.length +
-            Number(pinned !== undefined) +
-            Number(visible.length < active.length), width);
-        for (const [index, row] of visible.entries()) {
-            this.hits.push({ start: 0, end: width, row: lines.length, key: row.task.key });
-            lines.push(this.row(row, width, index >= pulse));
-        }
-        const more = this.more(active.length - visible.length, width, lines.length);
-        if (more !== undefined) {
-            lines.push(more);
-        }
-        const pin = this.pin(pinned, width, lines.length);
-        if (pin !== undefined) {
-            lines.push(pin);
-        }
-        lines.push(...details);
-        return lines;
-    }
-}

package/dist/tui/agent-history.js

@@ -1,50 +0,0 @@
-import { stripAcceptanceReport } from "../runs/shared/acceptance-reports.js";
-import { readableText } from "./history-text.js";
-export { readableText } from "./history-text.js";
-export { indexedHistory } from "./indexed-history.js";
-function finalMatch(history, text) {
-    if (history.finalId !== undefined) {
-        return history.finalId;
-    }
-    if (history.findFinalResult) {
-        return history.findFinalResult(text);
-    }
-    return history.items.findLast((item) => item.kind === "assistant" &&
-        (stripAcceptanceReport(item.text).trim() === text ||
-            item.assistant?.content.some((part) => part.type === "text" && stripAcceptanceReport(readableText(part.text)).trim() === text) === true))?.id;
-}
-/** Canonical run output is already validated; never decode arbitrary tool JSON to find an answer. */
-export function withFinalResult(history, output, runId, timestamp) {
-    const text = readableText(output).trim();
-    if (text.length === 0) {
-        return history;
-    }
-    const matched = finalMatch(history, text);
-    const existing = history.items.some((item) => item.id === matched) ? matched : undefined;
-    const id = `result:${runId}`;
-    let items;
-    return {
-        get items() {
-            items ??=
-                existing !== undefined
-                    ? history.items.map((item) => item.id === existing
-                        ? { ...item, assistant: undefined, previewAssistant: undefined, text }
-                        : item)
-                    : [...history.items, { id, kind: "assistant", title: "Saved result", text, timestamp }];
-            return items;
-        },
-        entryIds: existing !== undefined ? history.entryIds : [...history.entryIds, id],
-        finalId: existing ?? id,
-        findFinalResult: existing !== undefined
-            ? history.findFinalResult
-            : (value) => (value === text ? id : history.findFinalResult?.(value)),
-        deliveredMessages: existing !== undefined
-            ? history.deliveredMessages
-            : history.deliveredMessages &&
-                new Map([...history.deliveredMessages.keys()].map((messageId) => [messageId, true])),
-        configuration: history.configuration,
-        get unavailable() {
-            return history.unavailable;
-        },
-    };
-}