@fitchmultz/pi-subagents 0.49.1 → 0.51.0

package/dist/tui/conversation-history.js

@@ -1,210 +0,0 @@
-import { errorText } from "./text-values.js";
-import { isDeepStrictEqual } from "node:util";
-import { historyStatus, pageNotices, taskNotices, outgoingHistory, } from "./conversation-notices.js";
-import { getSingleResultOutput } from "../shared/utils.js";
-import { withFinalResult } from "./agent-history.js";
-import { UNAVAILABLE_ASSIGNMENT } from "./view-model.js";
-export class ConversationHistory {
-    loadingPage = false;
-    refreshPending = false;
-    pageError;
-    latestPage = true;
-    seenSource = false;
-    pageRequest = 0;
-    closed = false;
-    tui;
-    controller;
-    key;
-    source;
-    constructor(tui, controller, key, source) {
-        this.tui = tui;
-        this.controller = controller;
-        this.key = key;
-        this.source = source;
-        this.seenSource = Boolean(controller.task(key)?.page?.count);
-    }
-    active(request) {
-        return !this.closed && request === this.pageRequest;
-    }
-    async loadPage(paging = {}, anchor) {
-        if (this.closed) {
-            return;
-        }
-        const request = ++this.pageRequest;
-        this.refreshPending = false;
-        this.loadingPage = true;
-        this.pageError = undefined;
-        this.controller.setHistoryLoading(this.key, true);
-        this.latestPage =
-            paging.before === undefined && paging.after === undefined && paging.cursor === undefined;
-        this.tui.requestRender();
-        try {
-            await this.resolvePage(paging, anchor, request);
-        }
-        catch (error) {
-            if (this.active(request)) {
-                this.pageError = `History unavailable: ${errorText(error)}. F5 retries the selected run.`;
-            }
-        }
-        finally {
-            this.finishPage(request);
-        }
-    }
-    finishPage(request) {
-        if (!this.active(request)) {
-            return;
-        }
-        this.loadingPage = false;
-        this.controller.setHistoryLoading(this.key, false);
-        if (this.refreshPending && this.pageError === undefined) {
-            this.refreshPending = false;
-            this.source.refresh();
-        }
-        this.tui.requestRender();
-    }
-    async resolvePage(paging, anchor, request) {
-        const selected = await this.controller.historyPage(this.key, paging, anchor);
-        if (!selected || !this.active(request)) {
-            return;
-        }
-        const result = await this.initialReportPage(selected, request);
-        if (!result || !this.active(request)) {
-            return;
-        }
-        const history = await this.savedReport(result, request);
-        if (history && this.active(request)) {
-            if (!result.isCurrent()) {
-                await this.loadPage(paging, anchor);
-                return;
-            }
-            if (result.readThroughSequence !== undefined) {
-                this.source.readSequence(result.readThroughSequence);
-            }
-            this.latestPage = result.latestPage;
-            this.applyPage(history, result);
-        }
-    }
-    needsInitialReport(result) {
-        const task = this.controller.task(this.key), visit = this.source.initialVisit();
-        if (!task ||
-            !this.source.initialPosition() ||
-            visit.readThrough !== undefined ||
-            visit.anchor ||
-            task.child.state === "live") {
-            return false;
-        }
-        const finalId = result.history.finalId;
-        return finalId !== undefined && !result.history.entryIds.includes(finalId);
-    }
-    async initialReportPage(result, request) {
-        if (!this.controller.task(this.key)) {
-            return;
-        }
-        if (!this.needsInitialReport(result)) {
-            return result;
-        }
-        const report = await this.controller.historyPage(this.key, {}, result.history.finalId);
-        if (!this.active(request) || !this.controller.task(this.key)) {
-            return;
-        }
-        return report ?? result;
-    }
-    includeReport(history, latestPage) {
-        return (this.source.initialPosition() ||
-            latestPage ||
-            (history.finalId !== undefined && history.entryIds.includes(history.finalId)));
-    }
-    async savedReport(result, request) {
-        const task = this.controller.task(this.key);
-        if (!task) {
-            return;
-        }
-        const history = result.history;
-        const includeReport = this.includeReport(history, result.latestPage);
-        if (!includeReport ||
-            task.child.state === "live" ||
-            !task.child.result ||
-            getSingleResultOutput(task.child.result).length === 0) {
-            return history;
-        }
-        const runId = task.run.runId;
-        const report = await this.controller.savedResult(this.key, `result:${runId}`);
-        const current = this.controller.task(this.key);
-        if (!this.active(request) || !current || current.run.runId !== runId) {
-            return;
-        }
-        return withFinalResult(history, report.text, runId, current.run.updatedAt);
-    }
-    applyPage(history, result) {
-        const task = this.controller.task(this.key);
-        if (!task) {
-            return;
-        }
-        const items = history.items.map((item) => item.id === `result:${task.run.runId}`
-            ? { ...item, load: () => this.controller.savedResult(this.key, item.id) }
-            : item);
-        const previous = task.page, sameSource = previous !== undefined &&
-            previous.sourceId === result.page.sourceId &&
-            previous.generation === result.page.generation &&
-            previous.sessionId === result.page.sessionId &&
-            previous.sourceState === result.page.sourceState &&
-            isDeepStrictEqual(previous.entries.map((entry) => entry.ref), result.page.entries.map((entry) => entry.ref));
-        this.seenSource ||= result.page.count > 0;
-        this.controller.applyHistoryPage(this.key, { ...history, items }, result.page, this.seenSource);
-        if (!sameSource) {
-            this.source.clearCards();
-        }
-    }
-    assignment() {
-        const task = this.controller.task(this.key);
-        if (!task) {
-            return {
-                id: "assignment",
-                kind: "notice",
-                title: "Assignment unavailable",
-                text: UNAVAILABLE_ASSIGNMENT,
-                timestamp: 0,
-            };
-        }
-        return {
-            id: "assignment",
-            kind: "notice",
-            title: task.child.identityUnavailable === true
-                ? "Assignment unavailable"
-                : `Assignment · ${task.child.agent}`,
-            text: task.child.identityUnavailable === true
-                ? UNAVAILABLE_ASSIGNMENT
-                : `${task.model.details}\n\n${task.child.task ?? "The original per-child assignment was not saved for this older run."}`,
-            timestamp: task.run.startedAt,
-        };
-    }
-    items(detail) {
-        const task = this.controller.task(this.key);
-        if (!task) {
-            return [
-                {
-                    id: "unavailable",
-                    kind: "notice",
-                    title: "Agent unavailable",
-                    text: "The owning session or run is no longer available.",
-                    timestamp: 0,
-                },
-            ];
-        }
-        if (detail) {
-            return [detail];
-        }
-        const status = this.pageError ?? historyStatus(task.page, this.loadingPage);
-        return [
-            this.assignment(),
-            ...pageNotices(task, status, this.latestPage),
-            ...task.history,
-            ...taskNotices(task),
-            ...this.controller.visit(this.key).outbox.map(outgoingHistory),
-        ];
-    }
-    dispose() {
-        this.closed = true;
-        this.pageRequest++;
-    }
-}

package/dist/tui/conversation-menu.js

@@ -1,78 +0,0 @@
-import { primaryKey, activity } from "./view-model.js";
-import { matchesKey } from "@earendil-works/pi-tui";
-function taskCanControl(task) {
-    return task?.child.identityUnavailable !== true && task?.child.activity?.status !== "pending";
-}
-export function conversationChoices(task, options) {
-    const choices = [
-        { value: "reply", label: "Reply to selected message / tool / change" },
-        { value: "details", label: "Full details / diff" },
-        { value: "expand", label: options.expanded ? "Collapse tool output" : "Expand tool output" },
-        { value: "assignment", label: "Full original assignment" },
-        { value: "changes", label: "Inspect working tree changes" },
-        { value: "latest", label: "Jump to latest activity" },
-        { value: "pin", label: options.pinned ? "Unpin this agent" : "Keep this agent visible" },
-    ];
-    if (options.quote) {
-        choices.push({ value: "unquote", label: "Remove quoted context" });
-    }
-    if (taskCanControl(task)) {
-        choices.push(task?.child.state === "live" || task?.question
-            ? { value: "stop", label: "Stop this agent only" }
-            : { value: "continue", label: "Continue with this message" });
-    }
-    choices.push({ value: "picker", label: "Your other agents" }, { value: "peers", label: "Other connected sessions" }, { value: "earlier", label: "Earlier history" }, { value: "later", label: "Later history" }, { value: "retry", label: "Refresh / retry selected history" });
-    return choices;
-}
-const SHORTCUTS = [
-    ["escape", "back"],
-    ["f2", "actions"],
-    ["f5", "retry"],
-    ["alt+r", "reply"],
-    ["alt+g", "changes"],
-    ["alt+l", "latest"],
-    ["alt+p", "pin"],
-    ["alt+q", "unquote"],
-    ["alt+s", "stop"],
-    ["alt+c", "continue"],
-];
-export function conversationShortcut(data) {
-    return SHORTCUTS.find(([key]) => matchesKey(data, key))?.[1];
-}
-export function primaryConversationAction(task, editor) {
-    if (!taskCanControl(task)) {
-        return;
-    }
-    if (task?.child.state !== "live" && !task?.question) {
-        return "continue";
-    }
-    return editor ? "send" : "details";
-}
-function composeLabel(task, busy) {
-    return `${task?.question ? "Answer" : "Message"} ${task?.label ?? "agent"}${busy ? " · sending" : ""}`;
-}
-export function conversationHeading(task, options) {
-    return {
-        title: `${options.entrance} › ${task?.label ?? "unavailable"}${options.detail ? " › details" : ""}`,
-        status: task
-            ? `${task.child.agent} · ${activity(task)} · ${task.model.summary}`
-            : "Unavailable",
-        unread: task?.unread === true && !options.following,
-        composeLabel: composeLabel(task, options.busy),
-    };
-}
-export function primaryConversationHint(action, width, loading, task) {
-    if (loading) {
-        return "Loading quoted context…";
-    }
-    if (task?.child.identityUnavailable === true) {
-        return "Assignment unavailable · draft kept";
-    }
-    if (task?.child.activity?.status === "pending") {
-        return "Waiting to start · draft kept";
-    }
-    if (action === "continue") {
-        return width < 60 ? "Alt+C Continue" : "Alt+C Continue with message";
-    }
-    return action === "send" ? `${primaryKey("tui.input.submit")} Send`.trim() : "Enter Details";
-}

package/dist/tui/conversation-notices.js

@@ -1,79 +0,0 @@
-import { hasText } from "./text-values.js";
-import { acceptanceHumanAction } from "../runs/shared/acceptance.js";
-import { formatAgentProcessExit } from "../shared/status-format.js";
-function notice(id, title, text = "", timestamp = 0) {
-    return { id, kind: "notice", title, text, timestamp };
-}
-export function historyStatus(page, loading) {
-    if (loading && !page) {
-        return "Loading conversation…";
-    }
-    if (page?.freshness.state === "catching-up") {
-        return "Catching up · partial history";
-    }
-    return page?.freshness.state === "degraded"
-        ? "Some saved history unavailable · F5 retry"
-        : undefined;
-}
-export function pageNotices(task, status, latest) {
-    const items = [], page = task.page;
-    if (hasText(status)) {
-        items.push(notice("history-loading", status));
-    }
-    if (page && page.count > page.entries.length) {
-        items.push(notice("history-page", `History · ${page.entries.length} of ${page.count} native records${latest ? " · latest" : ""}`, "F2 Actions → Earlier history / Later history / Latest. Full details validates the selected native record."));
-    }
-    if (task.child.identityUnavailable !== true && task.child.state !== "live") {
-        items.push(notice("process-exit", `Agent: ${task.child.state}`, formatAgentProcessExit(task.child.result?.agentProcessExit), task.run.updatedAt));
-    }
-    return items;
-}
-function activityItem(task) {
-    const activity = task.child.activity;
-    if (task.child.identityUnavailable === true ||
-        task.child.state !== "live" ||
-        !hasText(activity?.streamingText)) {
-        return;
-    }
-    return {
-        id: `live:${task.run.runId}`,
-        kind: "assistant",
-        title: "Agent · writing",
-        text: activity.streamingText,
-        timestamp: activity.lastActivityAt ?? 0,
-    };
-}
-export function taskNotices(task) {
-    const items = [];
-    if (task.child.identityUnavailable !== true) {
-        const action = task.child.humanAction ?? acceptanceHumanAction(task.child.result?.acceptance);
-        if (hasText(action)) {
-            items.push(notice("human-action", "Needs your action — acceptance incomplete", action, task.run.updatedAt));
-        }
-        if (hasText(task.unavailable)) {
-            items.push(notice("unavailable", "Conversation unavailable", task.unavailable));
-        }
-    }
-    if (task.question) {
-        items.push(notice(`question:${task.question.questionId}`, "Waiting for your answer", task.question.message, task.question.createdAt));
-    }
-    const activity = activityItem(task);
-    if (activity) {
-        items.push(activity);
-    }
-    return items;
-}
-const SENT_TITLES = {
-    sending: "You · sending",
-    waiting: "You · waiting for the child / tool boundary",
-    unconfirmed: "You · delivery unconfirmed",
-};
-export function outgoingHistory(sent) {
-    return {
-        id: `outgoing:${sent.id}`,
-        kind: "user",
-        title: SENT_TITLES[sent.status],
-        text: `${sent.text}${sent.quote ? `\n\nRegarding ${sent.quote.title}:\n${sent.quote.text}` : ""}${hasText(sent.reason) ? `\n\n${sent.reason}` : ""}`,
-        timestamp: sent.at,
-    };
-}

package/dist/tui/conversation-selection.js

@@ -1,58 +0,0 @@
-/** Conversation selection and per-card expansion are independent of draft/control state. */
-export class ConversationSelection {
-    id;
-    toolsExpanded = false;
-    toolExpansion = new Map();
-    cards;
-    scroll;
-    constructor(cards, scroll) {
-        this.cards = cards;
-        this.scroll = scroll;
-    }
-    selected(detail) {
-        return (detail ??
-            this.cards.contentItems.find((item) => item.id === this.id) ??
-            this.cards.contentItems.findLast((item) => item.kind === "assistant"));
-    }
-    mouse(event, detail) {
-        if (event.type !== "click" || event.button !== "left") {
-            return;
-        }
-        const row = this.cards.lines.find((candidate) => candidate.start <= event.y + this.scroll.scrollTop &&
-            candidate.end > event.y + this.scroll.scrollTop);
-        if (!row) {
-            return;
-        }
-        this.id = row.id;
-        const item = this.selected();
-        if ((item?.call || item?.result) && !detail) {
-            this.toolExpansion.set(row.id, !(this.toolExpansion.get(row.id) ?? this.toolsExpanded));
-        }
-        else {
-            this.cards.dispatch(row.id, {
-                ...event,
-                y: event.y + this.scroll.scrollTop - row.contentStart,
-                height: row.end - row.contentStart,
-            });
-        }
-        return { handled: true, focus: true };
-    }
-    select(delta, height) {
-        const current = this.cards.lines.findIndex((row) => row.id === this.id);
-        const visible = current < 0 ? this.cards.lines.findIndex((row) => row.end > this.scroll.scrollTop) : current;
-        const index = Math.max(0, Math.min(this.cards.lines.length - 1, visible + delta));
-        const row = this.cards.lines.at(index);
-        if (!row) {
-            return false;
-        }
-        this.id = row.id;
-        if (row.start < this.scroll.scrollTop || row.start >= this.scroll.scrollTop + height) {
-            this.scroll.scrollTo(row.start, { disableFollow: true });
-        }
-        return true;
-    }
-    expand() {
-        this.toolsExpanded = !this.toolsExpanded;
-        this.toolExpansion.clear();
-    }
-}

package/dist/tui/conversation-viewport.js

@@ -1,129 +0,0 @@
-import { ScrollView, } from "@earendil-works/pi-tui";
-function firstUnread(ids, readThrough) {
-    if (readThrough === null) {
-        return ids.at(0);
-    }
-    if (readThrough === undefined) {
-        return;
-    }
-    const index = ids.indexOf(readThrough);
-    return index >= 0 ? ids.at(index + 1) : undefined;
-}
-export class ConversationViewport {
-    scroll;
-    initialPosition = true;
-    restoreAnchor;
-    readSequence = -1;
-    height = 1;
-    lastWidth;
-    tui;
-    cards;
-    source;
-    mouse;
-    constructor(tui, cards, source, mouse) {
-        this.tui = tui;
-        this.cards = cards;
-        this.source = source;
-        this.mouse = mouse;
-        this.scroll = new ScrollView(source.content, { follow: "end", scrollbar: "hidden" });
-    }
-    invalidate() {
-        this.scroll.invalidate();
-    }
-    handleMouse(event) {
-        return this.mouse(event);
-    }
-    anchor() {
-        const row = this.cards.lines.findLast((candidate) => candidate.start <= this.scroll.scrollTop);
-        return row ? { id: row.id, line: this.scroll.scrollTop - row.start } : undefined;
-    }
-    initialize() {
-        const task = this.source.task();
-        if (!this.initialPosition || this.source.loading() || !task) {
-            return;
-        }
-        if (!task.page && task.child.identityUnavailable !== true) {
-            return;
-        }
-        this.initialPosition = false;
-        const initial = this.source.initialVisit;
-        const unread = firstUnread(task.historyIds, initial.readThrough);
-        this.restoreAnchor = unread !== undefined ? { id: unread, line: 0 } : initial.anchor;
-        this.restoreFinal(task);
-    }
-    restoreFinal(task) {
-        if (!this.restoreAnchor && task.finalId !== undefined) {
-            this.restoreAnchor = { id: task.finalId, line: 0 };
-            // The finished report is the starting point; earlier activity stays available above it.
-            const finalIndex = task.historyIds.indexOf(task.finalId);
-            this.source.visit().readThrough ??=
-                finalIndex > 0 ? (task.historyIds.at(finalIndex - 1) ?? null) : null;
-        }
-    }
-    restore() {
-        const anchor = this.restoreAnchor;
-        if (!anchor) {
-            return;
-        }
-        const row = this.cards.lines.find((candidate) => candidate.entryIds.includes(anchor.id));
-        if (row) {
-            this.scroll.scrollTo(row.start + Math.min(anchor.line, Math.max(0, row.end - row.start - 1)), { disableFollow: true });
-        }
-        this.restoreAnchor = undefined;
-    }
-    visibleRead(task) {
-        const seen = new Set(this.cards.lines
-            .filter((row) => row.end > this.scroll.scrollTop && row.end <= this.scroll.scrollTop + this.height)
-            .flatMap((row) => row.entryIds));
-        const index = task.historyIds.findLastIndex((id) => seen.has(id));
-        const entry = task.historyIds.at(index);
-        if (index < 0 || entry === undefined) {
-            return;
-        }
-        const id = entry.startsWith("result:") ? (task.page?.latestEntryId ?? entry) : entry;
-        const nativeId = id.replace(/:(?:\d+|error)$/, "");
-        const sequence = task.page?.entries.find((record) => record.id === nativeId)?.sequence;
-        return sequence === undefined ? undefined : { id, index, sequence };
-    }
-    advanceRead(task) {
-        if (!task) {
-            return;
-        }
-        const visit = this.source.visit(), read = this.visibleRead(task);
-        const priorIndex = typeof visit.readThrough === "string" ? task.historyIds.indexOf(visit.readThrough) : -1;
-        if (read &&
-            (read.sequence > this.readSequence ||
-                (read.sequence === this.readSequence && read.index > priorIndex))) {
-            visit.readThrough = read.id;
-            this.readSequence = read.sequence;
-        }
-    }
-    recordRead() {
-        if (this.source.detail() || this.source.loading() || this.initialPosition) {
-            return;
-        }
-        const task = this.source.task(), visit = this.source.visit();
-        visit.anchor = this.scroll.isFollowingEnd ? undefined : this.anchor();
-        this.advanceRead(task);
-        visit.readThrough ??= null;
-        if (this.scroll.isFollowingEnd) {
-            visit.seenActivityAt = task?.child.activity?.lastActivityAt ?? Date.now();
-        }
-    }
-    render(width) {
-        if (this.lastWidth !== width && !this.scroll.isFollowingEnd) {
-            this.restoreAnchor ??= this.anchor();
-        }
-        this.lastWidth = width;
-        const lines = this.scroll.render(width);
-        this.scroll.updateLayout(lines.length, this.height, () => this.tui.requestRender());
-        this.initialize();
-        this.restore();
-        const visible = lines.slice(this.scroll.scrollTop, this.scroll.scrollTop + this.height);
-        while (visible.length < this.height) {
-            visible.push("");
-        }
-        this.recordRead();
-        return visible;
-    }
-}

package/dist/tui/direction-message.js

@@ -1,27 +0,0 @@
-import { keyText } from "@earendil-works/pi-coding-agent";
-import { Text } from "@earendil-works/pi-tui";
-import { withMouseExpansion } from "./action-hints.js";
-import { short } from "./view-model.js";
-import { hasText } from "./text-values.js";
-export function directionRenderer() {
-    return withMouseExpansion((message, options, theme) => {
-        const details = message.details;
-        if (!details) {
-            return;
-        }
-        return {
-            render(width) {
-                const key = keyText("app.tools.expand");
-                const quote = details.quote
-                    ? `\n\nReplying to ${details.quote.title}:\n${details.quote.text}`
-                    : "";
-                const expanded = `User → ${details.label}\n${details.text}${quote}`;
-                const compact = theme.fg("dim", `User → ${details.label}: ${short(details.text, 100)} · sent directly${hasText(key) ? ` · ${key}` : ""}`);
-                return new Text(options.expanded ? expanded : compact, 0, 0).render(width);
-            },
-            invalidate() {
-                /* The message renderer creates themed text on every render. */
-            },
-        };
-    });
-}