@fitchmultz/pi-subagents 0.49.1 → 0.50.0

package/src/pi-intercom/ui/overlay.ts

@@ -1,238 +0,0 @@
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { IntercomTransport } from "../transport.ts";
-import type { IntercomLifecycle } from "../lifecycle.ts";
-import type { IntercomConnection } from "../connection.ts";
-import type { IntercomTopics } from "../topics.ts";
-import type { SessionInfo } from "../types.ts";
-import { TOPICS_UNAVAILABLE, type IntercomSessionScope } from "../runtime-types.ts";
-import { errorMessage } from "../validation.ts";
-import { targetDisplayName } from "../session-targets.ts";
-import { sessionsForScope } from "./session-format.ts";
-import { SessionListOverlay } from "./session-list.ts";
-import { ComposeOverlay, type ComposeResult } from "./compose.ts";
-type Lifecycle = Readonly<Pick<IntercomLifecycle, "generation" | "live" | "notify">>;
-type Connection = Readonly<Pick<IntercomConnection, "ensure" | "syncIdentity">>;
-type TopicOwner = Readonly<Pick<IntercomTopics, "disconnected" | "open" | "refresh">>;
-
-interface OverlayOwners {
-  readonly pi: ExtensionAPI;
-  readonly lifecycle: Lifecycle;
-  readonly connection: Connection;
-  readonly topics: TopicOwner;
-}
-interface SessionChoices {
-  readonly current: SessionInfo;
-  readonly peers: readonly SessionInfo[];
-  readonly all: readonly SessionInfo[];
-  readonly hidden: number;
-}
-function sentResult(
-  result: Readonly<ComposeResult> | undefined | null,
-): { readonly messageId: string; readonly text: string; readonly expectsReply: boolean } | null {
-  if (result?.sent !== true) {
-    return null;
-  }
-  const messageId = result.messageId ?? "";
-  const text = result.text ?? "";
-  return messageId === "" || text === ""
-    ? null
-    : { messageId, text, expectsReply: result.expectsReply === true };
-}
-export class IntercomOverlay {
-  private readonly owners: OverlayOwners;
-  constructor(owners: OverlayOwners) {
-    this.owners = owners;
-  }
-  private notify(ctx: ExtensionContext, generation: number, message: string): void {
-    this.owners.lifecycle.notify(ctx, message, "error", generation);
-  }
-  private async connect(
-    ctx: ExtensionContext,
-    generation: number,
-  ): Promise<IntercomTransport | null> {
-    try {
-      return await this.owners.connection.ensure("overlay");
-    } catch (error) {
-      this.notify(ctx, generation, `Intercom unavailable: ${errorMessage(error)}`);
-      return null;
-    }
-  }
-  private async choices(
-    active: IntercomTransport,
-    scope: IntercomSessionScope,
-  ): Promise<SessionChoices> {
-    const id = active.sessionId;
-    if (id === null || id === "") {
-      throw new Error("Current intercom session id is unavailable.");
-    }
-    const all = await active.listSessions();
-    const current = all.find((session) => session.id === id);
-    if (!current) {
-      throw new Error("Current session is missing from intercom session list");
-    }
-    const scoped = sessionsForScope(all, id, scope);
-    return {
-      current,
-      peers: scoped.filter((session) => session.id !== id),
-      all,
-      hidden: all.length - scoped.length,
-    };
-  }
-  private async select(
-    ctx: ExtensionContext,
-    choices: SessionChoices,
-  ): Promise<SessionInfo | undefined | null> {
-    return await ctx.ui
-      .custom<SessionInfo | undefined>(
-        (tui, theme, keybindings, done) =>
-          new SessionListOverlay(tui, theme, {
-            keybindings,
-            currentSession: choices.current,
-            sessions: choices.peers,
-            done,
-            hiddenSessionCount: choices.hidden,
-            allSessions: choices.all,
-          }),
-        { overlay: true },
-      )
-      .catch(() => null);
-  }
-  private async compose(
-    ctx: ExtensionContext,
-    active: IntercomTransport,
-    selected: SessionInfo,
-    all: readonly SessionInfo[],
-  ): Promise<ComposeResult | undefined | null> {
-    return await ctx.ui
-      .custom<ComposeResult>(
-        (tui, theme, keybindings, done) =>
-          new ComposeOverlay(tui, theme, {
-            keybindings,
-            target: selected,
-            targetLabel: targetDisplayName(selected, all),
-            client: active,
-            done,
-          }),
-        { overlay: true },
-      )
-      .catch(() => null);
-  }
-  private async choose(
-    ctx: ExtensionContext,
-    scope: IntercomSessionScope,
-    generation: number,
-  ): Promise<{ readonly selected: SessionInfo; readonly all: readonly SessionInfo[] } | null> {
-    const active = await this.connect(ctx, generation);
-    if (!active || !this.owners.lifecycle.live(ctx, generation)) {
-      return null;
-    }
-    this.owners.connection.syncIdentity(ctx.sessionManager.getSessionId());
-    let choices: SessionChoices;
-    try {
-      choices = await this.choices(active, scope);
-    } catch (error) {
-      this.notify(ctx, generation, `Failed to list sessions: ${errorMessage(error)}`);
-      return null;
-    }
-    if (!this.owners.lifecycle.live(ctx, generation)) {
-      return null;
-    }
-    const selected = await this.select(ctx, choices);
-    return selected ? { selected, all: choices.all } : null;
-  }
-  private record(
-    ctx: ExtensionContext,
-    generation: number,
-    sent: { readonly messageId: string; readonly text: string; readonly expectsReply: boolean },
-    selection: { readonly selected: SessionInfo; readonly all: readonly SessionInfo[] },
-  ): void {
-    if (!this.owners.lifecycle.live(ctx, generation)) {
-      return;
-    }
-    const { selected, all } = selection;
-    this.owners.pi.appendEntry("intercom_sent", {
-      to: selected.name === undefined || selected.name === "" ? selected.id : selected.name,
-      message: { text: sent.text, expectsReply: sent.expectsReply },
-      messageId: sent.messageId,
-      timestamp: Date.now(),
-    });
-    this.owners.lifecycle.notify(
-      ctx,
-      `${sent.expectsReply ? "Ask sent" : "Message sent"} to ${targetDisplayName(selected, all)}`,
-      "info",
-      generation,
-    );
-  }
-  async open(ctx: ExtensionContext, scope: IntercomSessionScope = "project"): Promise<void> {
-    const generation = this.owners.lifecycle.generation;
-    const live = this.owners.lifecycle.live(ctx, generation);
-    if (!live || !live.hasUI || live.mode !== "tui") {
-      return;
-    }
-    const selection = await this.choose(ctx, scope, generation);
-    if (!selection || !this.owners.lifecycle.live(ctx, generation)) {
-      return;
-    }
-    const active = await this.connect(ctx, generation);
-    if (!active || !this.owners.lifecycle.live(ctx, generation)) {
-      return;
-    }
-    const sent = sentResult(await this.compose(ctx, active, selection.selected, selection.all));
-    if (sent) {
-      this.record(ctx, generation, sent, selection);
-    }
-  }
-  private async topics(ctx: ExtensionContext): Promise<void> {
-    const generation = this.owners.lifecycle.generation;
-    let notice: string | undefined;
-    try {
-      const active = await this.owners.connection.ensure("overlay");
-      if (!active.supportsTopics) {
-        notice = TOPICS_UNAVAILABLE;
-        this.owners.topics.disconnected();
-      } else {
-        const sessions = await active.listSessions();
-        if (this.owners.lifecycle.live(ctx, generation)) {
-          this.owners.topics.refresh(sessions);
-        }
-      }
-    } catch {
-      if (this.owners.lifecycle.live(ctx, generation)) {
-        this.owners.topics.disconnected();
-        notice = "Broker unavailable; last saved topic records follow.";
-      }
-    }
-    if (this.owners.lifecycle.live(ctx, generation) && ctx.mode === "tui") {
-      await this.owners.topics.open(ctx, notice);
-    }
-  }
-  register(shortcut: Parameters<ExtensionAPI["registerShortcut"]>[0]): void {
-    this.owners.pi.registerCommand("intercom", {
-      description:
-        "Open peer messaging; 'all' includes other projects, 'topics' inspects quiet topic/owner state",
-      handler: async (args, ctx) => {
-        const scope = args.trim();
-        if (scope === "topics") {
-          await this.topics(ctx);
-          return;
-        }
-        if (scope !== "" && scope !== "all") {
-          ctx.ui.notify("Usage: /intercom [all|topics]", "warning");
-          return;
-        }
-        await this.open(ctx, scope === "all" ? "all" : "project");
-      },
-    });
-    this.owners.pi.registerShortcut(shortcut, {
-      description: "Toggle your agents, or open connected sessions",
-      handler: async (ctx) => {
-        // The event contract intentionally permits its owner to mark the request handled synchronously.
-        const request = { ctx, handled: false };
-        this.owners.pi.events.emit("subagent:open-agents", request);
-        if (!request.handled) {
-          await this.open(ctx);
-        }
-      },
-    });
-  }
-}

package/src/pi-intercom/ui/session-list.ts

@@ -1,222 +0,0 @@
-import {
-  type Component,
-  type SelectItem,
-  type TUI,
-  type TuiMouseEvent,
-  Box,
-  Container,
-  SelectList,
-  Text,
-  sliceByColumn,
-  truncateToWidth,
-  visibleWidth,
-} from "@earendil-works/pi-tui";
-import { actionHints } from "../../tui/action-hints.ts";
-import type { KeybindingsManager, Theme } from "@earendil-works/pi-coding-agent";
-import type { SessionInfo } from "../types.ts";
-import { formatSessionTarget } from "../session-targets.ts";
-
-function sessionTitle(
-  session: SessionInfo,
-  allSessions: readonly SessionInfo[],
-  suffix?: string,
-): string {
-  return `${(session.name ?? "").length > 0 ? (session.name ?? "") : "Unnamed session"} (${formatSessionTarget(session, allSessions)})${suffix !== undefined && suffix.length > 0 ? ` [${suffix}]` : ""}`;
-}
-
-export interface SessionListOptions {
-  readonly keybindings: KeybindingsManager;
-  readonly currentSession: SessionInfo;
-  readonly sessions: readonly SessionInfo[];
-  readonly done: (result: SessionInfo | undefined) => void;
-  readonly hiddenSessionCount?: number;
-  readonly allSessions?: readonly SessionInfo[];
-}
-
-function sessionDescription(session: SessionInfo): string {
-  const resources =
-    session.topics
-      ?.filter((topic) => (topic.resource ?? "").length > 0 && topic.ownership === "held")
-      .map((topic) => `Using ${topic.resource ?? ""}`)
-      .join(" · ") ?? "";
-  return `${resources.length > 0 ? resources : `Native session cwd: ${session.cwd}`} • ${session.model}`;
-}
-
-export class SessionListOverlay extends Container {
-  private completed = false;
-  private readonly selectList: SelectList;
-  private readonly allSessions: readonly SessionInfo[];
-  private readonly tui: TUI;
-  private readonly theme: Theme;
-  private readonly options: SessionListOptions;
-  private readonly hiddenSessionCount: number;
-
-  constructor(tui: TUI, theme: Theme, options: SessionListOptions) {
-    super();
-    this.tui = tui;
-    this.theme = theme;
-    this.options = options;
-    const { sessions, currentSession } = options;
-    this.hiddenSessionCount = options.hiddenSessionCount ?? 0;
-    this.allSessions = options.allSessions ?? [currentSession, ...sessions];
-    const items: SelectItem[] = sessions.map((session) => ({
-      value: session.id,
-      label: sessionTitle(
-        session,
-        this.allSessions,
-        session.cwd === currentSession.cwd ? "same native session cwd" : undefined,
-      ),
-      description: sessionDescription(session),
-    }));
-    this.selectList = new SelectList(items, 8, {
-      selectedPrefix: (text) => theme.fg("accent", text),
-      selectedText: (text) => theme.fg("accent", text),
-      description: (text) => theme.fg("dim", text),
-      scrollInfo: (text) => theme.fg("dim", text),
-      noMatch: (text) => theme.fg("dim", text),
-    });
-    this.selectList.onSelect = (item) =>
-      this.finish(sessions.find((session) => session.id === item.value));
-    this.selectList.onCancel = () => this.finish();
-  }
-
-  private finish(result?: SessionInfo): void {
-    if (this.completed) {
-      return;
-    }
-    this.completed = true;
-    this.options.done(result);
-  }
-
-  dispose(): void {
-    this.completed = true;
-  }
-
-  handleMouse(event: Readonly<TuiMouseEvent>): ReturnType<Container["handleMouse"]> {
-    const width = Math.min(event.width, 88);
-    if (this.completed || event.x >= width) {
-      return;
-    }
-    return super.handleMouse({ ...event, width });
-  }
-
-  handleInput(data: string): void {
-    if (this.completed) {
-      return;
-    }
-    if (this.options.sessions.length === 0) {
-      if (this.options.keybindings.matches(data, "tui.select.cancel")) {
-        this.finish();
-      }
-    } else {
-      this.selectList.handleInput(data);
-    }
-    this.tui.requestRender();
-  }
-
-  private emptyLines(row: (text: string) => string): string[] {
-    const messages =
-      this.hiddenSessionCount > 0
-        ? [
-            " No other sessions in this project",
-            ` ${this.hiddenSessionCount} in other project${this.hiddenSessionCount === 1 ? "" : "s"} hidden`,
-            " Run /intercom all to show every connected session",
-          ]
-        : [
-            " No other intercom-connected sessions",
-            " Start another session with: pi --name worker",
-            ' Then run intercom({ action: "list" }) again',
-          ];
-    return messages.map((message) => row(this.theme.fg("dim", message)));
-  }
-
-  private controls(): Component {
-    const message = [this.options.keybindings.getKeys("tui.select.confirm").join("/"), "Message"]
-      .filter(Boolean)
-      .join(": ");
-    const close = [this.options.keybindings.getKeys("tui.select.cancel").join("/"), "Close"]
-      .filter(Boolean)
-      .join(": ");
-    return actionHints(
-      [
-        " ",
-        ...(this.options.sessions.length > 0
-          ? [
-              {
-                text: message,
-                run: () => {
-                  const item = this.selectList.getSelectedItem();
-                  if (item) {
-                    this.selectList.onSelect?.(item);
-                  }
-                },
-              },
-              " • ",
-            ]
-          : []),
-        { text: close, run: () => this.finish() },
-      ],
-      (text) => this.theme.fg("dim", text),
-      "",
-    );
-  }
-
-  render(width: number): string[] {
-    this.clear();
-    if (width < 3) {
-      return [truncateToWidth("Intercom", width)];
-    }
-    const innerWidth = Math.min(width, 88);
-    const contentWidth = Math.max(1, innerWidth - 2);
-    const border = (text: string) => this.theme.fg("accent", text);
-    const row = (text = "") => {
-      const clipped = truncateToWidth(text, contentWidth, "", true);
-      return `${border("│")}${clipped}${" ".repeat(Math.max(0, contentWidth - visibleWidth(clipped)))}${border("│")}`;
-    };
-
-    const framed = (component: Component) => {
-      const box = new Box(1, 0, (line) => row(sliceByColumn(line, 1, contentWidth)));
-      box.addChild(component);
-      return box;
-    };
-    const lines = [
-      border(`╭${"─".repeat(contentWidth)}╮`),
-      row(this.theme.bold(" Current Session")),
-      border(`├${"─".repeat(contentWidth)}┤`),
-      row(
-        `  ${this.theme.fg("dim", sessionTitle(this.options.currentSession, this.allSessions, "self"))}`,
-      ),
-      row(
-        `  ${this.theme.fg("dim", `Native session cwd: ${this.options.currentSession.cwd} • ${this.options.currentSession.model}`)}`,
-      ),
-      border(`├${"─".repeat(contentWidth)}┤`),
-      row(this.theme.bold(" Other Sessions")),
-    ];
-
-    this.addChild(new Text(lines.join("\n"), 0, 0));
-    if (this.options.sessions.length === 0) {
-      this.addChild(new Text(this.emptyLines(row).join("\n"), 0, 0));
-    } else {
-      this.addChild(framed(this.selectList));
-      if (this.hiddenSessionCount > 0) {
-        this.addChild(
-          new Text(
-            row(
-              this.theme.fg(
-                "dim",
-                ` ${this.hiddenSessionCount} other-project session${this.hiddenSessionCount === 1 ? "" : "s"} hidden · /intercom all`,
-              ),
-            ),
-            0,
-            0,
-          ),
-        );
-      }
-    }
-
-    this.addChild(new Text(border(`├${"─".repeat(contentWidth)}┤`), 0, 0));
-    this.addChild(framed(this.controls()));
-    this.addChild(new Text(border(`╰${"─".repeat(contentWidth)}╯`), 0, 0));
-    return super.render(innerWidth);
-  }
-}

package/src/pi-intercom/ui/tool-renderers.ts

@@ -1,148 +0,0 @@
-import { keyText, type Theme } from "@earendil-works/pi-coding-agent";
-import { Text } from "@earendil-works/pi-tui";
-import type { ToolRenderContext } from "../runtime-types.ts";
-import { previewText } from "../message-format.ts";
-import { firstTextContent } from "../tool-results.ts";
-import { isRecord, isUnknownArray } from "../validation.ts";
-interface RenderResult {
-  readonly content?: readonly { readonly type: string; readonly text?: string }[];
-  readonly details?: unknown;
-}
-interface RenderOptions {
-  readonly expanded?: boolean;
-  readonly isPartial: boolean;
-}
-function failed(
-  context: ToolRenderContext,
-  details: Readonly<Record<string, unknown>> | undefined,
-): boolean {
-  return context.isError === true || details?.error === true || details?.accepted === false;
-}
-function contactColor(reason: string): "warning" | "muted" | "accent" {
-  if (reason === "need_decision") {
-    return "warning";
-  }
-  return reason === "progress_update" ? "muted" : "accent";
-}
-export function renderContactCall(args: unknown, theme: Theme): Text {
-  const record = isRecord(args) ? args : {};
-  const reason = typeof record.reason === "string" ? record.reason : "contact";
-  const preview = previewText(record.message, 96);
-  const interview = isRecord(record.interview) ? record.interview : undefined;
-  let text =
-    theme.fg("toolTitle", theme.bold("contact_supervisor ")) +
-    theme.fg(contactColor(reason), reason);
-  if (typeof interview?.title === "string" && interview.title.trim() !== "") {
-    text += ` ${theme.fg("accent", interview.title.trim())}`;
-  }
-  if (preview !== undefined && preview !== "") {
-    text += `\n  ${theme.fg("dim", preview)}`;
-  }
-  return new Text(text, 0, 0);
-}
-export function renderContactResult(
-  result: RenderResult,
-  options: RenderOptions,
-  theme: Theme,
-  context: ToolRenderContext,
-): Text {
-  if (options.isPartial) {
-    return new Text(theme.fg("warning", "Waiting for supervisor..."), 0, 0);
-  }
-  const details = isRecord(result.details) ? result.details : undefined;
-  const failure = failed(context, details);
-  const warning = typeof details?.structuredReplyParseError === "string";
-  let prefix = theme.fg("success", "✓ ");
-  if (failure) {
-    prefix = theme.fg("error", "✗ ");
-  } else if (warning) {
-    prefix = theme.fg("warning", "⚠ ");
-  }
-  let text = prefix + theme.fg(failure ? "error" : "text", firstTextContent(result));
-  if (typeof details?.structuredReplyParseError === "string") {
-    text += `\n${theme.fg("warning", `Structured reply parse issue: ${details.structuredReplyParseError}`)}`;
-  }
-  return new Text(text, 0, 0);
-}
-function actionColor(action: string): "warning" | "success" | "accent" {
-  if (action === "ask") {
-    return "warning";
-  }
-  return action === "reply" ? "success" : "accent";
-}
-export function renderIntercomCall(args: unknown, theme: Theme): Text {
-  const record = isRecord(args) ? args : {};
-  const action = typeof record.action === "string" ? record.action : "intercom";
-  const target = typeof record.to === "string" ? record.to.trim() : "";
-  const preview = previewText(record.message, 96);
-  const count = isUnknownArray(record.attachments) ? record.attachments.length : 0;
-  let text = theme.fg("toolTitle", theme.bold("intercom ")) + theme.fg(actionColor(action), action);
-  if (target !== "") {
-    text += ` ${theme.fg("muted", "→")} ${theme.fg("accent", target)}`;
-  }
-  if (count > 0) {
-    text += ` ${theme.fg("dim", `(${count} attachment${count === 1 ? "" : "s"})`)}`;
-  }
-  if (preview !== undefined && preview !== "") {
-    text += `\n  ${theme.fg("dim", preview)}`;
-  }
-  return new Text(text, 0, 0);
-}
-function listSummary(details: Readonly<Record<string, unknown>> | undefined, theme: Theme): Text {
-  const count = details?.sessionCount;
-  const summary =
-    typeof count === "number" ? `${count} session${count === 1 ? "" : "s"}` : "Sessions listed";
-  const key = keyText("app.tools.expand");
-  return new Text(
-    `${theme.fg("success", "✓ ")}${theme.fg("text", summary)}${key !== "" ? ` ${theme.fg("dim", `(${key} to expand)`)}` : ""}`,
-    0,
-    0,
-  );
-}
-function messageSuffix(
-  details: Readonly<Record<string, unknown>> | undefined,
-  expanded: boolean,
-  theme: Theme,
-): string {
-  const id = details?.messageId;
-  return typeof id === "string" && id !== "" && !expanded
-    ? theme.fg("dim", ` (${id.slice(0, 8)})`)
-    : "";
-}
-function reasonSuffix(
-  details: Readonly<Record<string, unknown>> | undefined,
-  expanded: boolean,
-  theme: Theme,
-): string {
-  const reason = details?.reason;
-  return typeof reason === "string" && reason !== "" && expanded
-    ? `\n${theme.fg("dim", `Reason: ${reason}`)}`
-    : "";
-}
-function renderedText(result: RenderResult, failure: boolean, theme: Theme): string {
-  return (
-    theme.fg(failure ? "error" : "success", failure ? "✗ " : "✓ ") +
-    theme.fg(failure ? "error" : "text", firstTextContent(result))
-  );
-}
-export function renderIntercomResult(
-  result: RenderResult,
-  options: RenderOptions,
-  theme: Theme,
-  context: ToolRenderContext,
-): Text {
-  if (options.isPartial) {
-    return new Text(theme.fg("warning", "Intercom working..."), 0, 0);
-  }
-  const details = isRecord(result.details) ? result.details : undefined;
-  const failure = failed(context, details);
-  const action = isRecord(context.args) ? context.args.action : undefined;
-  if (!failure && action === "list" && options.expanded !== true) {
-    return listSummary(details, theme);
-  }
-  const text =
-    renderedText(result, failure, theme) +
-    messageSuffix(details, options.expanded === true, theme) +
-    reasonSuffix(details, options.expanded === true, theme);
-  return new Text(text, 0, 0);
-}