@fitchmultz/pi-subagents 0.49.0 → 0.50.0

package/src/tui/nested-widget.ts

@@ -1,192 +0,0 @@
-import { hasText } from "./text-values.ts";
-import { activityFacts, joinActivity } from "./activity-lines.ts";
-import type { ReadonlyInput, NestedRunSummary, NestedStepSummary } from "../shared/types.ts";
-import { formatNestedAggregate } from "../runs/shared/nested-render.ts";
-import { formatWidgetAgents } from "./widget-status.ts";
-import {
-  type Theme,
-  runningGlyph,
-  runningSeed,
-  buildLiveStatusLine,
-  truncLine,
-} from "./display.ts";
-
-function nestedRunName(run: ReadonlyInput<NestedRunSummary>): string {
-  if (hasText(run.agent)) {
-    return run.agent;
-  }
-  if ((run.agents?.length ?? 0) > 0) {
-    return formatWidgetAgents(run.agents ?? []);
-  }
-  return run.id;
-}
-
-function nestedStatusGlyph(
-  state: ReadonlyInput<NestedRunSummary["state"] | NestedStepSummary["status"]>,
-  theme: Theme,
-  seed?: number,
-): string {
-  if (state === "running") {
-    return theme.fg("accent", runningGlyph(seed));
-  }
-  if (state === "complete" || state === "completed") {
-    return theme.fg("success", "✓");
-  }
-  if (state === "failed") {
-    return theme.fg("error", "✗");
-  }
-  if (state === "blocked") {
-    return theme.fg("warning", "■");
-  }
-  if (state === "paused") {
-    return theme.fg("warning", "■");
-  }
-  return theme.fg("muted", "◦");
-}
-
-function nestedRunSeed(run: ReadonlyInput<NestedRunSummary>): number | undefined {
-  return runningSeed(
-    run.lastUpdate,
-    run.lastActivityAt,
-    run.currentStep,
-    run.toolCount,
-    run.turnCount,
-    run.totalTokens?.total,
-    run.currentToolStartedAt,
-  );
-}
-
-function nestedActivity(
-  input: ReadonlyInput<
-    Pick<
-      NestedRunSummary | NestedStepSummary,
-      | "activityState"
-      | "lastActivityAt"
-      | "currentTool"
-      | "currentToolStartedAt"
-      | "currentPath"
-      | "turnCount"
-      | "toolCount"
-    >
-  >,
-  state: NestedRunSummary["state"] | NestedStepSummary["status"],
-  snapshotNow?: number,
-): string {
-  const facts = activityFacts(input, snapshotNow);
-  const fallback: Readonly<
-    Record<NestedRunSummary["state"] | NestedStepSummary["status"], string>
-  > = {
-    running: "thinking…",
-    queued: "queued…",
-    pending: "queued…",
-    blocked: "Needs your action",
-    paused: "Paused",
-    failed: "Failed",
-    complete: "Done",
-    completed: "Done",
-    "timed-out": "Failed",
-  };
-  return joinActivity(facts, buildLiveStatusLine(input, snapshotNow), fallback[state]);
-}
-
-class NestedLines {
-  private readonly lines: string[] = [];
-  private readonly theme: Theme;
-  private readonly width: number;
-  private readonly now: number | undefined;
-  private readonly budget: number;
-  constructor(
-    theme: Theme,
-    width: number,
-    options: { readonly snapshotNow?: number; readonly lineBudget?: number },
-  ) {
-    this.theme = theme;
-    this.width = width;
-    this.now = options.snapshotNow;
-    this.budget = options.lineBudget ?? 12;
-  }
-  render(children: ReadonlyInput<NestedRunSummary[]> | undefined): string[] {
-    this.append(children, 0, "");
-    return this.lines.map((line) => truncLine(line, this.width));
-  }
-  private aggregate(
-    items: ReadonlyInput<NestedRunSummary[]>,
-    prefix: string,
-    replace = false,
-  ): void {
-    const aggregate = formatNestedAggregate(items);
-    if (!hasText(aggregate)) {
-      return;
-    }
-    const line = this.theme.fg("dim", `${prefix}↳ ${aggregate}`);
-    if (replace) {
-      this.lines[this.lines.length - 1] = line;
-    } else if (this.lines.length < this.budget) {
-      this.lines.push(line);
-    }
-  }
-  private append(
-    items: ReadonlyInput<NestedRunSummary[]> | undefined,
-    depth: number,
-    prefix: string,
-  ): void {
-    if (!items || items.length === 0 || this.lines.length >= this.budget) {
-      return;
-    }
-    if (depth > 2) {
-      this.aggregate(items, prefix);
-      return;
-    }
-    for (const [index, child] of items.entries()) {
-      if (this.lines.length >= this.budget) {
-        this.aggregate(items.slice(index), prefix, true);
-        return;
-      }
-      this.child(child, depth, prefix);
-    }
-  }
-  private child(child: ReadonlyInput<NestedRunSummary>, depth: number, prefix: string): void {
-    const now = this.now ?? child.lastUpdate;
-    const activity = nestedActivity(child, child.state, now),
-      error = hasText(child.error) ? ` · ${child.error}` : "";
-    this.lines.push(
-      this.theme.fg(
-        "dim",
-        `${prefix}↳ ${nestedStatusGlyph(child.state, this.theme, nestedRunSeed(child))} ${nestedRunName(child)} · ${child.state} · ${activity}${error}`,
-      ),
-    );
-    if (depth === 2) {
-      this.aggregate(
-        [...(child.steps?.flatMap((step) => step.children ?? []) ?? []), ...(child.children ?? [])],
-        `${prefix}  `,
-      );
-      return;
-    }
-    for (const step of child.steps ?? []) {
-      if (this.lines.length >= this.budget) {
-        return;
-      }
-      this.lines.push(
-        this.theme.fg(
-          "dim",
-          `${prefix}  ↳ ${nestedStatusGlyph(step.status, this.theme)} ${step.agent} · ${step.status} · ${nestedActivity(step, step.status, now)}`,
-        ),
-      );
-      this.append(step.children, depth + 1, `${prefix}    `);
-    }
-    this.append(child.children, depth + 1, `${prefix}  `);
-  }
-}
-
-/** Expanded-only, bounded tree layout. The local renderer owns its line budget. */
-export function formatNestedWidgetLines(
-  children: ReadonlyInput<NestedRunSummary[] | undefined>,
-  theme: Theme,
-  width: number,
-  options: { readonly snapshotNow?: number; readonly lineBudget?: number } = {},
-): string[] {
-  if (!children || children.length === 0 || (options.lineBudget ?? 12) <= 0) {
-    return [];
-  }
-  return new NestedLines(theme, width, options).render(children);
-}

package/src/tui/picker-page.ts

@@ -1,80 +0,0 @@
-import { visibleWidth, type SelectItem } from "@earendil-works/pi-tui";
-import type { PickerController } from "./view-ports.ts";
-import { short, taskSummary, type AgentTask } from "./view-model.ts";
-import { hasText } from "./text-values.ts";
-export interface PickerPage {
-  readonly items: readonly Readonly<SelectItem>[];
-  readonly task?: Readonly<AgentTask>;
-  readonly status: string;
-  readonly selectedIndex: number;
-}
-function pageStatus(controller: PickerController): string {
-  if (controller.listError !== undefined) {
-    return controller.listError;
-  }
-  if (controller.listPage?.freshness.state === "catching-up") {
-    return "Catching up · partial results";
-  }
-  if (controller.listPage?.freshness.state === "degraded") {
-    return "Some history unavailable · F5 retry";
-  }
-  return controller.listLoading ? "Loading…" : "";
-}
-function pageItems(
-  controller: PickerController,
-  query: string,
-): { readonly tasks: readonly Readonly<AgentTask>[]; readonly items: SelectItem[] } {
-  const rows = controller.listPage?.rows ?? [];
-  const tasks = controller.tasks.filter((task) => rows.some((run) => run.runId === task.run.runId));
-  const items = tasks.map((task) => {
-    const { status, badge } = taskSummary(task);
-    return {
-      value: task.key,
-      label: `${task.child.agent} · ${task.label}`,
-      description: status + badge,
-    };
-  });
-  if ((controller.listPage?.offset ?? 0) > 0) {
-    items.push({ value: "previous-page", label: "Previous agents", description: "PgUp" });
-  }
-  if (controller.listPage?.nextOffset !== undefined) {
-    items.push({ value: "next-page", label: "More agents", description: "PgDn" });
-  }
-  items.push({ value: "retry", label: "Refresh / retry history", description: "F5" });
-  if (!hasText(query)) {
-    items.push({ value: "peers", label: "Other connected sessions", description: "All projects" });
-  }
-  return { tasks, items };
-}
-export function pickerPage(
-  controller: PickerController,
-  query: string,
-  innerWidth: number,
-  selected: string | undefined,
-): PickerPage {
-  const { tasks, items } = pageItems(controller, query);
-  const labelWidth = Math.min(
-    Math.max(0, ...items.map((item) => visibleWidth(item.label))),
-    Math.max(40, Math.floor(innerWidth / 2)),
-  );
-  for (const [index, task] of tasks.entries()) {
-    const item = items.at(index);
-    if (!item) {
-      continue;
-    }
-    const modelWidth = innerWidth - labelWidth - visibleWidth(item.description ?? "") - 7;
-    if (modelWidth >= 16) {
-      item.description = `${item.description ?? ""} · ${short(task.model.summary, modelWidth)}`;
-    }
-  }
-  const selectedIndex = Math.max(
-    0,
-    items.findIndex((item) => item.value === selected),
-  );
-  return {
-    items,
-    selectedIndex,
-    task: controller.task(items.at(selectedIndex)?.value ?? ""),
-    status: pageStatus(controller),
-  };
-}

package/src/tui/render.ts

@@ -1,104 +0,0 @@
-import { keyText } from "@earendil-works/pi-coding-agent";
-import { Container, Text, TruncatedText, type Component } from "@earendil-works/pi-tui";
-import type { ReadonlyInput, SubagentExecutionResult } from "../shared/types.ts";
-import { firstOutputLine, getTermWidth, truncLine, type Theme } from "./display.ts";
-import { renderSingleCompact, renderMultiCompact } from "./compact-results.ts";
-import { renderSingleExpanded } from "./expanded-single.ts";
-import { renderMultiExpanded } from "./expanded-multi.ts";
-import { workflowFacts, type DetailsInput } from "./result-facts.ts";
-import { hasText } from "./text-values.ts";
-export { widgetRenderKey } from "./widget-status.ts";
-export { buildWidgetLines, renderWidget } from "./widget.ts";
-// Native rendering can receive text-only failures before application details exist.
-type Result = ReadonlyInput<Pick<SubagentExecutionResult, "content" | "isError">> & {
-  readonly details?: DetailsInput;
-};
-function asyncReceipt(
-  d: DetailsInput | undefined,
-  text: string,
-  prefix: string,
-  theme: Theme,
-): Component | undefined {
-  if (!d || !hasText(d.asyncId) || d.mode === "management") {
-    return;
-  }
-  const headline = hasText(d.managementControl?.revivedFromRunId)
-    ? "Revived async"
-    : firstOutputLine(text).replace(` [${d.asyncId}]`, "");
-  const c = new Container();
-  c.addChild(new TruncatedText(`${prefix}[${d.asyncId.slice(0, 8)}] ${headline}`));
-  c.addChild(new TruncatedText(theme.fg("dim", `${keyText("app.tools.expand")} details`)));
-  return c;
-}
-function compactText(text: string, prefix: string, theme: Theme): Component {
-  const lines = text.replace(/\n+$/, "").split("\n");
-  if (lines.length === 1) {
-    return new Text(truncLine(`${prefix}${lines[0] ?? ""}`, getTermWidth() - 4), 0, 0);
-  }
-  const visible = lines.slice(0, 12),
-    expand = keyText("app.tools.expand");
-  if (lines.length > visible.length) {
-    visible.push(
-      theme.fg(
-        "dim",
-        `+${lines.length - visible.length} more${hasText(expand) ? ` · ${expand} expands` : ""}`,
-      ),
-    );
-  }
-  return new Text(`${prefix}${visible.join("\n")}`, 0, 0);
-}
-function textResult(result: Result, expanded: boolean, theme: Theme, isError: boolean): Component {
-  const d = result.details,
-    first = result.content.at(0),
-    text = first?.type === "text" ? first.text : "(no output)";
-  const prefix = d?.context === "fork" ? `${theme.fg("warning", "[fork]")} ` : "";
-  if (expanded) {
-    return new Text(`${prefix}${text}`, 0, 0);
-  }
-  const receipt = isError ? undefined : asyncReceipt(d, text, prefix, theme);
-  return receipt ?? compactText(text, prefix, theme);
-}
-function singleResult(d: DetailsInput): boolean {
-  return d.mode === "single" && d.results.length === 1;
-}
-function expandedResult(
-  result: Result,
-  d: DetailsInput,
-  theme: Theme,
-  isError: boolean,
-): Component {
-  const facts = workflowFacts(d, isError),
-    showRun = isError || facts.failed || facts.blocked || facts.paused;
-  const receipt =
-    showRun || d.intercomDelivery?.delivered === true
-      ? result.content
-          .filter((part) => part.type === "text")
-          .map((part) => part.text)
-          .join("\n")
-      : undefined;
-  const settings = { isError, showRun, receipt },
-    first = d.results.at(0);
-  if (singleResult(d) && first) {
-    return renderSingleExpanded(d, first, theme, settings);
-  }
-  return renderMultiExpanded(d, theme, settings);
-}
-export function renderSubagentResult(
-  result: Result,
-  options: { readonly expanded: boolean },
-  theme: Theme,
-  context?: { readonly isError: boolean },
-): Component {
-  const isError = context?.isError ?? result.isError ?? false,
-    d = result.details;
-  if (!d || d.results.length === 0) {
-    return textResult(result, options.expanded, theme, isError);
-  }
-  if (options.expanded) {
-    return expandedResult(result, d, theme, isError);
-  }
-  const first = d.results.at(0);
-  return singleResult(d) && first
-    ? renderSingleCompact(d, first, theme, isError)
-    : renderMultiCompact(d, theme, isError);
-}

package/src/tui/result-facts.ts

@@ -1,99 +0,0 @@
-import type { ReadonlyInput, Details, AgentProgress } from "../shared/types.ts";
-import { getSingleResultOutput } from "../shared/utils.ts";
-import { workflowGraphHasStatus } from "./workflow-labels.ts";
-import { hasEmptyTextOutputWithoutOutputTarget } from "./display.ts";
-
-export type ResultInput = ReadonlyInput<Details["results"][number]>;
-export type DetailsInput = ReadonlyInput<Details>;
-export type ProgressInput = ReadonlyInput<AgentProgress>;
-
-export function workflowFacts(
-  d: DetailsInput,
-  isError: boolean,
-): {
-  running: boolean;
-  failed: boolean;
-  blocked: boolean;
-  paused: boolean;
-} {
-  return {
-    running:
-      !isError &&
-      (d.progress?.some((p) => p.status === "running") === true ||
-        d.results.some((r) => r.progress?.status === "running") ||
-        workflowGraphHasStatus(d, ["running"])),
-    failed:
-      isError ||
-      workflowGraphHasStatus(d, ["failed", "timed-out"]) ||
-      d.results.some((r) => r.exitCode !== 0 && r.progress?.status !== "running"),
-    blocked:
-      d.results.some((r) => r.acceptance?.status === "blocked" && r.exitCode === 0) ||
-      workflowGraphHasStatus(d, ["blocked"]),
-    paused:
-      d.results.some(
-        (r) => (r.interrupted === true || r.detached === true) && r.progress?.status !== "running",
-      ) || workflowGraphHasStatus(d, ["paused", "detached"]),
-  };
-}
-
-export function totalProgress(
-  d: DetailsInput,
-): { toolCount: number; tokens: number; durationMs: number } | undefined {
-  if (d.progressSummary) {
-    return d.progressSummary;
-  }
-  const progress = d.results.flatMap((r) => r.progress ?? r.progressSummary ?? []);
-  if (progress.length === 0) {
-    return;
-  }
-  return {
-    toolCount: progress.reduce((sum, p) => sum + p.toolCount, 0),
-    tokens: progress.reduce((sum, p) => sum + p.tokens, 0),
-    durationMs:
-      d.mode === "chain"
-        ? progress.reduce((sum, p) => sum + p.durationMs, 0)
-        : Math.max(...progress.map((p) => p.durationMs)),
-  };
-}
-
-export function resultProgress(
-  d: DetailsInput,
-  index: number,
-): ProgressInput | ResultInput["progressSummary"] {
-  const r = d.results.at(index);
-  if (!r) {
-    return;
-  }
-  return (
-    r.progress ??
-    d.progress?.find((p) => p.index === index) ??
-    d.progress?.find((p) => p.agent === r.agent && p.status === "running") ??
-    r.progressSummary
-  );
-}
-
-export function expandedResultStatus(
-  r: ResultInput,
-  running: boolean,
-  emptyWarning = false,
-): string {
-  if (running) {
-    return "running";
-  }
-  if (r.detached === true) {
-    return "detached";
-  }
-  if (r.interrupted === true) {
-    return "paused";
-  }
-  if (r.exitCode !== 0) {
-    return "failed";
-  }
-  if (r.acceptance?.status === "blocked") {
-    return "needs your action";
-  }
-  if (emptyWarning && hasEmptyTextOutputWithoutOutputTarget(r.task, getSingleResultOutput(r))) {
-    return "warning";
-  }
-  return "done";
-}

package/src/tui/task-observation.ts

@@ -1,96 +0,0 @@
-import type {
-  HistoryRunRow,
-  SupervisorQuestionView,
-  HistoryConfiguration,
-  ReadonlyInput,
-} from "../shared/types.ts";
-import { agentTaskLabel, type AgentTask, type AgentVisit } from "./view-model.ts";
-type Child = ReadonlyInput<HistoryRunRow["children"][number]>;
-type Task = Readonly<AgentTask>;
-export function selectedChild(child: Child, prior: Task, updatedAt: number): Child {
-  return {
-    ...child,
-    task: prior.child.task,
-    launch: prior.child.launch,
-    result: child.result && prior.run.updatedAt === updatedAt ? prior.child.result : child.result,
-    activity: { ...prior.child.activity, ...child.activity },
-  };
-}
-export function observedTask(
-  prior: Task | undefined,
-  state: Child["state"],
-  updatedAt: number,
-): boolean {
-  return prior !== undefined && prior.child.state === state && prior.metadataAt === updatedAt;
-}
-export function observedLabel(child: Child, prior: Task | undefined, sameAttempt: boolean): string {
-  if (child.identityUnavailable === true) {
-    return "Saved assignment unavailable";
-  }
-  return sameAttempt ? agentTaskLabel(child) : (prior?.label ?? agentTaskLabel(child));
-}
-export function cachedHistory(
-  prior: Task | undefined,
-): Pick<
-  AgentTask,
-  "history" | "historyIds" | "page" | "historyLoading" | "historySource" | "finalId" | "replied"
-> {
-  if (!prior) {
-    return { history: [], historyIds: [], historyLoading: false, replied: false };
-  }
-  return {
-    history: prior.history,
-    historyIds: prior.historyIds,
-    page: prior.page,
-    historySource: prior.historySource,
-    historyLoading: prior.historyLoading,
-    finalId: prior.finalId,
-    replied: prior.replied,
-  };
-}
-export function observedConfiguration(
-  child: Child,
-  prior: Task | undefined,
-  canonical: boolean,
-): HistoryConfiguration | undefined {
-  if (child.nativeConfiguration) {
-    return child.nativeConfiguration;
-  }
-  if (canonical && prior && child.sessionFile === prior.child.sessionFile) {
-    return prior.page?.configuration;
-  }
-  return;
-}
-export function activityUnread(
-  child: Child,
-  updatedAt: number,
-  visit: ReadonlyInput<AgentVisit> | undefined,
-): boolean {
-  return (
-    visit !== undefined &&
-    (child.activity?.lastActivityAt ?? updatedAt) > (visit.seenActivityAt ?? 0)
-  );
-}
-export function observationFlags(
-  prior: Task | undefined,
-  observed: boolean,
-  unread: boolean,
-): Pick<AgentTask, "metadataAt" | "unread"> {
-  return {
-    metadataAt: observed ? prior?.metadataAt : undefined,
-    unread: observed ? (prior?.unread ?? false) : unread,
-  };
-}
-export function observedQuestion(
-  child: Child,
-  questions: readonly SupervisorQuestionView[],
-): SupervisorQuestionView | undefined {
-  if (child.identityUnavailable === true) {
-    return;
-  }
-  return questions.findLast(
-    (question) =>
-      question.index === child.index &&
-      ["awaiting_input", "answer_pending"].includes(question.state),
-  );
-}