@fitchmultz/pi-subagents 0.49.1 → 0.51.0

package/dist/tui/agent-model.js

@@ -1,62 +0,0 @@
-import { formatModelThinking } from "../shared/formatters.js";
-import { readableText } from "./agent-history.js";
-import { hasText } from "./text-values.js";
-export const unavailableModel = {
-    summary: "model unavailable",
-    details: "Model unavailable. No provider/model was recorded for this assignment.",
-};
-function recordedModel(child, native) {
-    if (child.state === "live") {
-        return native;
-    }
-    const saved = child.savedConfiguration ?? child.launch;
-    return hasText(native?.model) ? { ...saved, ...native } : saved;
-}
-function fallbackModel(child, native) {
-    if (child.state === "live" && hasText(native?.model)) {
-        return native;
-    }
-    return hasText(child.launch?.model) ? child.launch : child.result;
-}
-function savedModelIsCurrent(child, recorded) {
-    const selected = child.modelSelection;
-    if (selected?.modelStartedAt === undefined) {
-        return child.state !== "live";
-    }
-    return (recorded.modelRecordedAt ?? 0) > selected.modelStartedAt;
-}
-function modelSelection(child, native) {
-    const recorded = recordedModel(child, native), selected = child.modelSelection;
-    if (hasText(recorded?.model) && savedModelIsCurrent(child, recorded)) {
-        return { value: recorded, source: child.state === "live" ? "session" : "saved" };
-    }
-    return hasText(selected?.model)
-        ? { value: selected, source: "selected" }
-        : { value: fallbackModel(child, native), source: "saved" };
-}
-function formattedModel(value) {
-    return hasText(value?.model)
-        ? readableText(formatModelThinking(value.model, value.thinking))
-        : undefined;
-}
-export function agentModel(child, native) {
-    if (child.identityUnavailable === true) {
-        return unavailableModel;
-    }
-    const selection = modelSelection(child, native), formatted = formattedModel(selection.value);
-    if (formatted === undefined) {
-        return unavailableModel;
-    }
-    const selected = formattedModel(child.modelSelection), saved = formattedModel(native);
-    const details = [`Model (${selection.source}): ${formatted}`];
-    if (selected !== undefined && selected !== formatted) {
-        details.push(`Selected model: ${selected}`);
-    }
-    if (child.state === "live" && saved !== undefined && saved !== formatted) {
-        details.push(`Last saved session model (may precede this attempt): ${saved}`);
-    }
-    return {
-        summary: selection.source === "session" ? formatted : `${selection.source}: ${formatted}`,
-        details: details.join("\n"),
-    };
-}

package/dist/tui/agent-picker.js

@@ -1,262 +0,0 @@
-import { hasText, errorText } from "./text-values.js";
-import { DynamicBorder, getSelectListTheme } from "@earendil-works/pi-coding-agent";
-import { Box, Container, Input, SelectList, Spacer, Text, getKeybindings, matchesKey, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
-import { readableText } from "./agent-history.js";
-import { actionHints } from "./action-hints.js";
-import { short, activity, primaryKey } from "./view-model.js";
-import { pickerPage } from "./picker-page.js";
-export class AgentPicker extends Container {
-    list;
-    itemKeys = [];
-    closed = false;
-    search;
-    signature = "";
-    wasPending = false;
-    retryError;
-    hasFocus = false;
-    tui;
-    theme;
-    controller;
-    done;
-    constructor(tui, theme, controller, done) {
-        super();
-        this.tui = tui;
-        this.theme = theme;
-        this.controller = controller;
-        this.done = done;
-        this.search = new Input({
-            placeholder: "Filter agents or assignments…",
-            placeholderStyle: (text) => theme.fg("dim", text),
-        });
-        this.search.setValue(controller.listFilter);
-        this.render(tui.terminal.columns);
-    }
-    get focused() {
-        return this.hasFocus;
-    }
-    set focused(value) {
-        this.hasFocus = value;
-        this.search.focused = value;
-    }
-    refresh() {
-        this.tui.requestRender();
-    }
-    retry() {
-        this.retryError = undefined;
-        this.controller.retry().catch((error) => {
-            if (!this.closed) {
-                this.retryError = errorText(error);
-                this.tui.requestRender();
-            }
-        });
-    }
-    header(page, width, compact) {
-        const header = new Container(), list = this.controller.listPage;
-        header.addChild(new Text(this.theme.fg("accent", this.theme.bold(truncateToWidth(`Agents · ${list?.total ?? "…"} owned runs · page ${Math.floor((list?.offset ?? 0) / 50) + 1}`, width))), 0, 0));
-        header.addChild(this.search);
-        const status = this.retryError ?? page.status;
-        if (hasText(status)) {
-            header.addChild(new Text(this.theme.fg(hasText(this.controller.listError) || this.retryError !== undefined ? "warning" : "dim", truncateToWidth(status, width)), 0, 0));
-        }
-        if (!compact) {
-            header.addChild(new Spacer(1));
-        }
-        return header;
-    }
-    controls(width, compact) {
-        const up = primaryKey("tui.select.up"), down = primaryKey("tui.select.down");
-        const choose = [
-            { text: up, run: () => this.act("up") },
-            hasText(up) && hasText(down) ? "/" : "",
-            { text: `${down}${compact ? "" : " Choose"}`, run: () => this.act("down") },
-        ];
-        const open = {
-            text: `${primaryKey("tui.select.confirm")}${compact ? "" : " Open"}`.trim(),
-            run: () => this.act("open"),
-        };
-        const back = {
-            text: `${primaryKey("tui.select.cancel")}${compact ? "" : " Back"}`.trim(),
-            run: () => this.act("back"),
-        };
-        const filter = { text: "Type to filter", run: () => this.act("filter") };
-        if (compact) {
-            return actionHints([...choose, " · ", open, " · ", back], (text) => this.theme.fg("dim", text));
-        }
-        const controls = width < 60
-            ? [...choose, " · ", open, "\n", back, " · ", filter]
-            : [filter, " · ", ...choose, " · ", open, " · ", back];
-        return actionHints(controls, (text) => this.theme.fg("dim", text));
-    }
-    footer(page, width, compact) {
-        const footer = new Container();
-        if (!compact) {
-            footer.addChild(new Spacer(1));
-        }
-        const task = page.task;
-        if (task && !compact) {
-            footer.addChild(new Text(this.theme.fg("muted", short(`${task.child.agent} · ${activity(task)} · ${task.run.runId.slice(0, 8)}`, width)), 0, 0));
-            footer.addChild(new Text(this.theme.fg("dim", short(task.model.summary, width)), 0, 0));
-            const assignment = new Text(readableText(task.child.task ?? "Original assignment unavailable."), 0, 0).render(width);
-            footer.addChild(new Text(assignment.slice(0, 3).join("\n"), 0, 0));
-        }
-        footer.addChild(this.controls(width + 2, compact));
-        return footer;
-    }
-    select(value) {
-        if (this.controller.listPending && !["retry", "peers"].includes(value)) {
-            return;
-        }
-        if (value === "next-page" || value === "previous-page") {
-            this.controller.pageTasks(value === "next-page" ? "later" : "earlier");
-        }
-        else if (value === "retry") {
-            this.retry();
-        }
-        else {
-            this.done(value);
-        }
-    }
-    selectList(page, width, visible) {
-        // Native SelectList needs more than ten cells to show its description column.
-        const descriptionWidth = width > 40
-            ? Math.max(11, ...page.items.map((item) => visibleWidth(item.description ?? "")))
-            : 0;
-        const primaryWidth = Math.max(1, width - descriptionWidth - (descriptionWidth > 0 ? 4 : 2));
-        const list = new SelectList([...page.items], visible, getSelectListTheme(), {
-            minPrimaryColumnWidth: Math.min(24, primaryWidth),
-            maxPrimaryColumnWidth: primaryWidth,
-            truncatePrimary: ({ text, maxWidth }) => truncateToWidth(text, maxWidth),
-        });
-        list.setSelectedIndex(page.selectedIndex);
-        list.onSelect = (item) => this.select(item.value);
-        list.onCancel = () => this.act("back");
-        return list;
-    }
-    layout(page, width, height) {
-        const innerWidth = Math.max(1, width - 2), compact = height < 16;
-        const header = this.header(page, innerWidth, compact), footer = this.footer(page, innerWidth, compact);
-        const visible = Math.max(1, height - 3 - header.render(innerWidth).length - footer.render(innerWidth).length);
-        this.list = this.selectList(page, innerWidth, visible);
-        const body = new Box(1, 0, (text) => this.theme.bg("customMessageBg", text));
-        body.addChild(header);
-        body.addChild(this.list);
-        body.addChild(footer);
-        this.clear();
-        this.addChild(new DynamicBorder((text) => this.theme.fg("borderAccent", text)));
-        this.addChild(body);
-        this.addChild(new DynamicBorder((text) => this.theme.fg("borderAccent", text)));
-    }
-    pageSignature(page, query, width, height) {
-        const task = page.task;
-        return JSON.stringify([
-            page.items,
-            query,
-            width,
-            height,
-            page.status,
-            this.retryError,
-            this.controller.listPage?.total,
-            page.items.at(page.selectedIndex)?.value,
-            task && activity(task),
-            task?.model,
-            task?.child.task,
-            task?.run.runId,
-        ]);
-    }
-    render(width) {
-        const height = this.controller.availableHeight(this.tui), query = this.search.getValue();
-        const selected = this.controller.listPending || this.wasPending
-            ? undefined
-            : this.list?.getSelectedItem()?.value;
-        this.wasPending = this.controller.listPending;
-        const page = pickerPage(this.controller, query, Math.max(1, width - 2), selected);
-        this.itemKeys = page.items.map((item) => item.value);
-        const signature = this.pageSignature(page, query, width, height);
-        if (signature !== this.signature) {
-            this.layout(page, width, height);
-            this.signature = signature;
-        }
-        return super.render(width);
-    }
-    invalidate() {
-        this.signature = "";
-        super.invalidate();
-    }
-    syncDraft() {
-        /* The picker has no conversation draft editor. */
-    }
-    move(delta) {
-        if (this.itemKeys.length === 0) {
-            return;
-        }
-        const index = this.itemKeys.indexOf(this.list?.getSelectedItem()?.value ?? "");
-        this.list?.setSelectedIndex((index + delta + this.itemKeys.length) % this.itemKeys.length);
-    }
-    act(action) {
-        if (this.closed) {
-            return;
-        }
-        switch (action) {
-            case "back":
-                this.done();
-                break;
-            case "filter":
-                this.tui.setFocus(this);
-                break;
-            case "open": {
-                const item = this.list?.getSelectedItem();
-                if (item) {
-                    this.select(item.value);
-                }
-                break;
-            }
-            case "up":
-                this.move(-1);
-                break;
-            case "down":
-                this.move(1);
-                break;
-        }
-        this.tui.requestRender();
-    }
-    listInput(data) {
-        const keys = getKeybindings();
-        if (keys.matches(data, "tui.select.cancel")) {
-            this.act("back");
-            return;
-        }
-        if (["tui.select.up", "tui.select.down", "tui.select.confirm"].some((key) => keys.matches(data, key))) {
-            this.list?.handleInput(data);
-        }
-        else {
-            const previous = this.search.getValue();
-            this.search.handleInput(data);
-            if (this.search.getValue() !== previous) {
-                this.list = undefined;
-            }
-            this.controller.filterTasks(this.search.getValue());
-        }
-    }
-    handleInput(data) {
-        if (this.closed) {
-            return;
-        }
-        if (matchesKey(data, this.controller.shortcut)) {
-            this.done();
-            return;
-        }
-        if (matchesKey(data, "pageDown") || matchesKey(data, "pageUp")) {
-            this.controller.pageTasks(matchesKey(data, "pageDown") ? "later" : "earlier");
-            return;
-        }
-        if (matchesKey(data, "f5")) {
-            this.retry();
-            return;
-        }
-        this.listInput(data);
-        this.tui.requestRender();
-    }
-    dispose() {
-        this.closed = true;
-    }
-}

package/dist/tui/agent-view.js

@@ -1,350 +0,0 @@
-import { hasText, errorText } from "./text-values.js";
-import { isRecord } from "./history-text.js";
-import { directionRenderer } from "./direction-message.js";
-import { pickerPort, conversationPort } from "./view-connections.js";
-import { AgentControls } from "./agent-controls.js";
-import { AgentBrowser } from "./agent-browser.js";
-import { ViewSession } from "./view-session.js";
-import { AgentTaskStore } from "./task-store.js";
-import { AgentDock } from "./agent-dock.js";
-import { loadConfig as loadIntercomConfig } from "../pi-intercom/config.js";
-import { isTuiContext } from "../shared/ui-mode.js";
-import { WIDGET_KEY } from "../shared/types.js";
-import { AgentConversation } from "./agent-conversation.js";
-import { AgentPicker } from "./agent-picker.js";
-const VIEW_ENTRY = "subagent-view";
-const DIRECTION_MESSAGE = "subagent-human-direction";
-function isSessionView(value) {
-    return (isRecord(value) &&
-        isRecord(value.sessionManager) &&
-        typeof value.sessionManager.getSessionId === "function");
-}
-function isOpenRequest(value) {
-    return (isRecord(value) &&
-        (value.ctx === undefined || isSessionView(value.ctx)) &&
-        (value.handled === undefined || typeof value.handled === "boolean"));
-}
-/** One UI controller over the existing owned runs, session files, and executor. */
-export class AgentViewController {
-    timer;
-    saveTimer;
-    unsubscribe;
-    lastSaved = "";
-    render;
-    closeOverlay;
-    widget;
-    shortcut = loadIntercomConfig().shortcut;
-    overlay;
-    pi;
-    state;
-    store;
-    session;
-    browser;
-    controls;
-    picker;
-    conversation;
-    /** Parent runtime notifications trigger an observation refresh, not a UI port operation. */
-    refresh(browse = false) {
-        return this.browser.refresh(browse);
-    }
-    reportFailure(error) {
-        if (this.live()) {
-            this.session.ctx?.ui.notify(`Agents: ${errorText(error)}`, "error");
-        }
-    }
-    constructor(pi, state, execute) {
-        this.pi = pi;
-        this.state = state;
-        this.store = new AgentTaskStore(state, () => this.overlay?.syncDraft());
-        this.session = new ViewSession(state);
-        this.browser = new AgentBrowser(state, this.store, this.session, () => {
-            this.overlay?.refresh();
-            this.render?.();
-        });
-        this.controls = new AgentControls(pi, this.store, this.session, {
-            execute,
-            changed: () => this.changed(),
-            save: () => this.save(),
-            refreshSelected: (key) => this.refreshSelected(key),
-            syncDraft: () => this.overlay?.syncDraft(),
-        });
-        const layout = {
-            shortcut: this.shortcut,
-            availableHeight: (tui) => this.availableHeight(tui),
-        };
-        this.picker = pickerPort(this.store, this.browser, layout);
-        this.conversation = conversationPort(this.store, this.browser, this.controls, {
-            ...layout,
-            changed: () => this.changed(),
-            pin: (key) => this.pin(key),
-        });
-        pi.registerCommand("agents", {
-            description: "View, message, answer, stop, or continue your agents",
-            handler: async (_args, ctx) => this.open(undefined, ctx),
-        });
-        pi.registerMessageRenderer(DIRECTION_MESSAGE, directionRenderer());
-    }
-    start(ctx) {
-        this.dispose();
-        if (!isTuiContext(ctx)) {
-            return;
-        }
-        this.session.start(ctx);
-        const ownerSessionId = ctx.sessionManager.getSessionId();
-        for (const entry of ctx.sessionManager.getEntries()) {
-            if (entry.type !== "custom" || entry.customType !== VIEW_ENTRY) {
-                continue;
-            }
-            this.store.restore(entry.data, ownerSessionId);
-        }
-        this.unsubscribe = this.pi.events.on("subagent:open-agents", (request) => {
-            if (!isOpenRequest(request)) {
-                return;
-            }
-            if (!this.live() || request.ctx?.sessionManager.getSessionId() !== ownerSessionId) {
-                return;
-            }
-            request.handled = true;
-            this.defer(this.open());
-        });
-        ctx.ui.setWidget(WIDGET_KEY, (tui, theme) => {
-            this.render = () => tui.requestRender();
-            const dock = new AgentDock(tui, theme, {
-                tasks: () => this.store.dockTasks,
-                pinned: () => this.store.tasks.find((task) => task.key === this.store.pinned),
-                page: () => this.browser.listPage,
-                error: () => this.browser.listError,
-                loading: () => this.browser.listLoading,
-                jobs: () => [...this.state.asyncJobs.values()],
-                expanded: () => ctx.ui.getToolsExpanded(),
-                below: () => this.componentsBelowWidget(tui) ?? [],
-                shortcut: this.shortcut,
-                live: () => this.live(),
-                unpin: () => this.pin(),
-                open: (key) => {
-                    this.open(key).catch((error) => this.reportFailure(error));
-                },
-            });
-            this.widget = dock.component;
-            return dock.component;
-        });
-        this.defer(this.browser.refresh());
-        this.timer = setInterval(() => {
-            if (this.shouldRefresh()) {
-                this.render?.();
-                this.defer(this.browser.refresh());
-            }
-        }, 500);
-        this.timer.unref();
-    }
-    defer(operation) {
-        operation.catch((error) => this.reportFailure(error));
-    }
-    shouldRefresh() {
-        if (hasText(this.browser.listError)) {
-            return false;
-        }
-        return (this.overlay !== undefined ||
-            hasText(this.store.pinned) ||
-            this.store.dockTasks.some((task) => task.child.state === "live" || task.question !== undefined) ||
-            this.store.tasks.some((task) => (this.store.visits.get(task.key)?.outbox.length ?? 0) > 0));
-    }
-    live(generation = this.session.generation) {
-        return this.session.live(generation);
-    }
-    refreshSelected(key) {
-        this.store.refreshSelected(key, this.session.ownerSessionId);
-        this.overlay?.refresh();
-        this.render?.();
-    }
-    changed() {
-        if (!this.live()) {
-            return;
-        }
-        if (this.saveTimer) {
-            clearTimeout(this.saveTimer);
-        }
-        this.saveTimer = setTimeout(() => this.save(), 300);
-        this.saveTimer.unref();
-        this.render?.();
-    }
-    save() {
-        if (this.saveTimer) {
-            clearTimeout(this.saveTimer);
-        }
-        this.saveTimer = undefined;
-        if (!this.live()) {
-            return;
-        }
-        const saved = {
-            ownerSessionId: this.session.context().sessionManager.getSessionId(),
-            visits: [...this.store.visits],
-            pinned: this.store.pinned,
-        };
-        const serialized = JSON.stringify(saved);
-        if (serialized === this.lastSaved) {
-            return;
-        }
-        this.pi.appendEntry(VIEW_ENTRY, saved);
-        this.lastSaved = serialized;
-    }
-    pin(key) {
-        this.store.pinned = key;
-        this.save();
-        this.render?.();
-    }
-    componentsBelowWidget(tui) {
-        if (!this.widget) {
-            return undefined;
-        }
-        // Public children work across loader boundaries; never render the parent history to measure the dock.
-        const parent = tui.children.find((child) => "children" in child &&
-            Array.isArray(child.children) &&
-            child.children.includes(this.widget));
-        return (parent && [
-            ...parent.children.slice(parent.children.indexOf(this.widget) + 1),
-            ...tui.children.slice(tui.children.indexOf(parent) + 1),
-        ]);
-    }
-    availableHeight(tui) {
-        if (tui.mode !== "fullscreen" || !this.widget) {
-            return Math.max(1, tui.terminal.rows - 2);
-        }
-        const below = this.componentsBelowWidget(tui);
-        if (!below) {
-            return Math.max(1, tui.terminal.rows - 2);
-        }
-        const dock = [this.widget, ...below].reduce((height, child) => height + child.render(tui.terminal.columns).length, 0);
-        return Math.max(1, tui.terminal.rows - dock - 1);
-    }
-    prepareOpen(ctx, key) {
-        if (this.session.ctx?.sessionManager.getSessionId() !== ctx.sessionManager.getSessionId()) {
-            this.start(ctx);
-        }
-        if (!this.live()) {
-            return;
-        }
-        if (this.overlay) {
-            this.closeOverlay?.(this.overlay instanceof AgentConversation && this.overlay.key === key ? undefined : key);
-            return;
-        }
-        return this.session.generation;
-    }
-    defaultSelection(key) {
-        if (key !== undefined) {
-            return key;
-        }
-        return this.browser.listFilter.length === 0 &&
-            this.store.tasks.length === 1 &&
-            this.browser.listPage?.total === 1
-            ? this.store.tasks.at(0)?.key
-            : undefined;
-    }
-    showOverlay(ctx, selected) {
-        let height;
-        const overlayOptions = {
-            width: "96%",
-            margin: 1,
-            anchor: "center",
-            get maxHeight() {
-                return height?.();
-            },
-        };
-        return ctx.ui.custom((tui, theme, keys, done) => {
-            height = () => this.availableHeight(tui);
-            if (tui.mode === "fullscreen") {
-                overlayOptions.anchor = "top-center";
-            }
-            this.closeOverlay = (next) => done(next);
-            this.overlay =
-                hasText(selected) && this.store.task(selected)
-                    ? new AgentConversation(tui, theme, {
-                        controller: this.conversation,
-                        key: selected,
-                        done,
-                        keys,
-                    })
-                    : new AgentPicker(tui, theme, this.picker, done);
-            return this.overlay;
-        }, { overlay: true, overlayOptions });
-    }
-    finishOverlay() {
-        this.overlay = undefined;
-        this.store.releaseSelected();
-        this.closeOverlay = undefined;
-        this.save();
-        this.defer(this.browser.refresh());
-    }
-    routeOverlay(result) {
-        if (result === "peers") {
-            this.pi.events.emit("intercom:open", {});
-            return;
-        }
-        if (!hasText(result)) {
-            return;
-        }
-        return { selected: result === "picker" ? undefined : result };
-    }
-    async open(key, ctx = this.session.ctx) {
-        if (!ctx || !isTuiContext(ctx)) {
-            return;
-        }
-        await this.openContext(ctx, key);
-    }
-    async openContext(ctx, key) {
-        const generation = this.prepareOpen(ctx, key);
-        if (generation === undefined) {
-            return;
-        }
-        if (!this.browser.listPage) {
-            await this.browser.refresh(true);
-        }
-        if (!this.live(generation)) {
-            return;
-        }
-        let selected = this.defaultSelection(key);
-        while (this.live(generation)) {
-            this.store.selectedKey = selected;
-            if (hasText(selected)) {
-                this.refreshSelected(selected);
-            }
-            // Only one native overlay owns focus at a time; each selection must close before its successor opens.
-            // oxlint-disable-next-line no-await-in-loop
-            const result = await this.showOverlay(ctx, selected);
-            if (!this.live(generation)) {
-                return;
-            }
-            this.finishOverlay();
-            const next = this.routeOverlay(result);
-            if (!next) {
-                return;
-            }
-            selected = next.selected;
-        }
-    }
-    dispose() {
-        this.save();
-        this.session.dispose();
-        this.browser.dispose();
-        this.closeOverlay?.();
-        this.overlay?.dispose();
-        this.closeOverlay = undefined;
-        this.overlay = undefined;
-        this.unsubscribe?.();
-        this.unsubscribe = undefined;
-        if (this.timer) {
-            clearInterval(this.timer);
-        }
-        if (this.saveTimer) {
-            clearTimeout(this.saveTimer);
-        }
-        this.timer = undefined;
-        this.saveTimer = undefined;
-        this.render = undefined;
-        this.widget = undefined;
-        this.controls.dispose();
-        this.store.reset();
-        this.lastSaved = "";
-    }
-}
-export { agentTaskLabel } from "./view-model.js";