@esso0428/pi-subagents 0.17.16 → 0.17.18

package/dist/ui/agent-mention.js

@@ -1,188 +0,0 @@
-/**
- * agent-mention.ts — what `@` can address, and the suggestions pi renders for it.
- *
- * A subagent is addressable whether or not it is currently running: a live
- * record is messaged or resumed, an evicted one whose session is still on disk
- * is reopened, and an agent *type* with no instance at all is started. That is
- * the point of the handle — `@explore` means the Explore agent, not "the
- * Explore process that happens to exist right now" — so the roster below unions
- * all three, and the dispatcher and the popup read the same list.
- *
- * Rows are per *agent*, not per handle. An agent given a `name` holds two names
- * (its alias and its type-derived handle) and both resolve, but it lists once,
- * under the alias, with its type moved into the description so the row still
- * says what it is.
- *
- * pi's `CombinedAutocompleteProvider` already owns `@`, where it means "attach a
- * file". Extensions can wrap it (`ctx.ui.addAutocompleteProvider`), so this
- * provider adds the `@` tokens that name an agent and delegates everything else
- * — including all of `applyCompletion`, whose `@`-branch already inserts
- * `item.value` plus a trailing space, which is exactly what a handle needs.
- *
- * Matching mirrors Claude Code: case-insensitive prefix, not fuzzy. What it does
- * NOT mirror is Claude Code dropping files whenever an agent matches. Here `@` is
- * pi's file picker first, and the handles are additive, so a token matching both
- * lists both — agents first. Suppressing on any match sounds narrow and is not:
- * an empty token prefix-matches every handle, so a bare `@` — the gesture people
- * use to browse files — would offer no files at all, and a single letter
- * beginning any handle would do the same.
- *
- * Both halves ship under ONE `prefix`, which is sound because wherever BOTH sides
- * produce rows they measured the same span. pi's `extractAtPrefix` takes the
- * token after the last of `{space, tab, ", ', =}` and keeps it only if it starts
- * with `@`; `MENTION_TRIGGER` matches `@[\w-]*` at the cursor, after start-of-line
- * or `[\s。、？！]`. Where those two disagree, exactly one side answers and there
- * is nothing to merge: `@src/index.ts` and `@"my file` are pi's alone (no handle
- * matches), `=@ex` is pi's alone (`=` is a delimiter to pi, not a boundary to us),
- * and `。@ex` is ours alone (the reverse). A merged response therefore never
- * carries a prefix from one side and an item from the other.
- *
- * Offering never-started types is a deliberate step beyond Claude Code, whose
- * registry holds only live tasks, so an agent you had not launched yet was
- * unaddressable.
- */
-import { handleBase, MENTION_TRIGGER } from "../mention.js";
-/**
- * Everything `@` can reach, in the order the popup lists it: steerable agents
- * first, then the other live ones earliest-launched, then agent types with no
- * live instance. A type whose handle a record already holds is omitted — that
- * name addresses the existing agent, which is what makes `@explore` mean
- * "message the one that's running" and only otherwise "start one".
- */
-export function mentionRoster(manager, types, 
-// Identity by default: a caller with no registry to consult gets the raw
-// type, which is also what `getConfig` falls back to when no label is set.
-displayNameOf = type => type) {
-    const live = (r) => r.status === "running" || r.status === "queued";
-    const records = manager.listAgents()
-        .filter(r => r.handle !== undefined && r.parentAgentId === undefined)
-        .sort((a, b) => (Number(live(b)) - Number(live(a))) || (a.startedAt - b.startedAt));
-    const taken = new Set();
-    const targets = [];
-    // One row per agent, not per handle. An aliased agent lists under its alias
-    // only — both names resolve, but showing two rows for one agent reads as two
-    // agents. The type handle stays addressable whether or not it is listed.
-    for (const record of records) {
-        const handle = record.alias ?? record.handle;
-        taken.add(handle.toLowerCase());
-        if (record.handle)
-            taken.add(record.handle.toLowerCase());
-        targets.push({ kind: "record", handle, record, typeLabel: displayNameOf(record.type) });
-    }
-    // Then agents that are gone but whose conversation can be reopened. After the
-    // live ones: a running agent is the likelier target, and this keeps the
-    // ordering "what exists now, then what can be brought back, then what can be
-    // started".
-    for (const entry of manager.listTombstones()) {
-        const handle = entry.alias ?? entry.handle;
-        if (taken.has(handle.toLowerCase()))
-            continue;
-        taken.add(handle.toLowerCase());
-        taken.add(entry.handle.toLowerCase());
-        targets.push({ kind: "tombstone", handle, entry, typeLabel: displayNameOf(entry.type) });
-    }
-    for (const type of types) {
-        const handle = handleBase(type.name);
-        if (taken.has(handle))
-            continue;
-        taken.add(handle);
-        targets.push({ kind: "type", handle, type: type.name, description: type.description });
-    }
-    return targets;
-}
-export function createMentionProvider(current, roster, isEnabled) {
-    // One warning per provider, not per keystroke: `getSuggestions` runs on every
-    // character typed after `@`, so an unguarded log would bury the terminal in
-    // the time it takes to finish a word.
-    let warnedInnerFailure = false;
-    return {
-        // Only `@` — the contract is "characters that should naturally trigger
-        // THIS provider", and pi unions each wrapper's own set onto the outermost
-        // one itself (interactive-mode.js:432), so re-declaring the wrapped
-        // provider's characters here would both misreport us and duplicate that.
-        triggerCharacters: ["@"],
-        async getSuggestions(lines, cursorLine, cursorCol, options) {
-            const mine = isEnabled() ? mentionItems(roster(), lines[cursorLine] ?? "", cursorCol) : null;
-            // Asked unconditionally: pi owns `@` and must keep answering for it even
-            // when a handle matches too. That is the same work vanilla pi does on any
-            // `@` keystroke — a capped `fd` search, or nothing at all when the host
-            // configured no `fd` path — but we now do it on tokens we used to answer
-            // alone, so it must not be able to take the popup down with it. The
-            // wrapped provider is not always pi's: another extension may sit inside
-            // us, and before this it was never called for a token naming an agent.
-            // try/catch, not `.catch()`: a provider that throws SYNCHRONOUSLY never
-            // returns the promise a `.catch()` would attach to, and the throw escapes
-            // this method as a rejection — which pi does not handle either
-            // (components/editor.js:1892 awaits with no catch of its own).
-            let theirs = null;
-            try {
-                theirs = await current.getSuggestions(lines, cursorLine, cursorCol, options);
-            }
-            catch (err) {
-                // Safe to treat as "no files": pi discards any response whose request is
-                // no longer current, so an aborted search that surfaces as a rejection
-                // cannot leave a stale popup behind (`isAutocompleteRequestCurrent`).
-                // Warned rather than swallowed outright — the failure is invisible in
-                // the popup, and the same `console.warn` channel already carries this
-                // extension's other non-fatal failures.
-                if (!warnedInnerFailure) {
-                    warnedInnerFailure = true;
-                    console.warn("[pi-subagents] the autocomplete provider below us failed; showing agent rows only:", err);
-                }
-                theirs = null;
-            }
-            if (!mine)
-                return theirs;
-            if (!theirs)
-                return mine;
-            // Agents first: there are a handful of them against pi's 20 file rows, and
-            // a handle buried under fuzzy path matches is a handle nobody finds. The
-            // prefix is ours by the span argument in the header — identical to pi's
-            // whenever both sides have something to say.
-            return { items: [...mine.items, ...theirs.items], prefix: mine.prefix };
-        },
-        applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
-            return current.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
-        },
-        shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
-            return current.shouldTriggerFileCompletion?.(lines, cursorLine, cursorCol) ?? true;
-        },
-    };
-}
-/** Suggestions for the `@…` token under the cursor, or null when it names no agent. */
-function mentionItems(roster, line, cursorCol) {
-    const match = MENTION_TRIGGER.exec(line.slice(0, cursorCol));
-    if (!match)
-        return null;
-    const typed = match[2].toLowerCase();
-    const items = [];
-    for (const target of roster) {
-        if (!target.handle.toLowerCase().startsWith(typed))
-            continue;
-        items.push({ value: `@${target.handle}`, label: `@${target.handle}`, description: describeTarget(target) });
-    }
-    return items.length > 0 ? { items, prefix: `@${match[2]}` } : null;
-}
-/** Name the action that will actually happen, so the list never mispromises. */
-function describeTarget(target) {
-    if (target.kind === "type")
-        return `start agent · ${summarize(target.description)}`;
-    if (target.kind === "tombstone") {
-        // No status: the record is gone, and "completed" would imply one is still
-        // being tracked. The type carries the identity the handle may not.
-        return `resume · ${target.typeLabel} · ${target.entry.description}`;
-    }
-    const { status, description, alias } = target.record;
-    const action = status === "running" || status === "queued" ? "send message" : "resume";
-    // A row listed under its alias has lost the type its handle would have shown,
-    // so name it — `@auth-audit` alone says nothing about what the agent is.
-    // A type-derived row already reads as its type and would just repeat itself.
-    const identity = alias ? `${target.typeLabel} · ` : "";
-    return `${action} · ${identity}${status} · ${description}`;
-}
-/** First sentence of an agent description, clipped — these run to paragraphs. */
-function summarize(description) {
-    const first = (description.match(/^.*?[.!?](?=\s|$)/s)?.[0] ?? description).replace(/\s+/g, " ").trim();
-    return first.length > 60 ? `${first.slice(0, 59).trimEnd()}…` : first;
-}
-//# sourceMappingURL=agent-mention.js.map

package/dist/ui/agent-mention.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-mention.js","sourceRoot":"","sources":["../../src/ui/agent-mention.ts"],"names":[],"mappings":"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"}

package/dist/ui/agent-widget.d.ts

@@ -1,241 +0,0 @@
-/**
- * agent-widget.ts — Persistent widget showing running/completed agents above the editor.
- *
- * Displays a tree of agents with animated spinners, live stats, and activity descriptions.
- * Uses the callback form of setWidget for themed rendering.
- */
-import type { AgentManager } from "../agent-manager.js";
-import type { AgentInvocation, AgentRecord, SubagentType, WidgetMode } from "../types.js";
-import { type LifetimeUsage, type SessionLike } from "../usage.js";
-/** Maximum number of rendered lines before overflow collapse kicks in. */
-export declare const MAX_WIDGET_LINES = 12;
-/**
- * Derive the widget ceiling from the terminal height while retaining the
- * historical MAX_WIDGET_LINES ceiling. Very short terminals may have no room
- * for the widget; that is preferable to consuming the editor/input area.
- */
-export declare function getWidgetLineBudget(rows: number): number;
-/** Braille spinner frames for animated running indicator. */
-export declare const SPINNER: string[];
-/** Statuses that indicate an error/non-success outcome (used for linger behavior and icon rendering). */
-export declare const ERROR_STATUSES: Set<string>;
-export type Theme = {
-    fg(color: string, text: string): string;
-    bold(text: string): string;
-};
-export type AgentWidgetOpenMode = "live" | "history";
-export type AgentWidgetOpenCallback = (record: AgentRecord, mode: AgentWidgetOpenMode) => void | Promise<void>;
-export interface AgentWidgetOptions {
-    canOpenHistory?: (record: AgentRecord) => boolean;
-    onOpen?: AgentWidgetOpenCallback;
-    showCost?: () => boolean;
-}
-/** @deprecated Use AgentWidgetOpenMode. */
-export type AgentOpenMode = AgentWidgetOpenMode;
-/** @deprecated Use AgentWidgetOpenCallback. */
-export type AgentOpenCallback = AgentWidgetOpenCallback;
-/** @deprecated Use AgentWidgetOptions.canOpenHistory. */
-export type AgentHistoryCapability = AgentWidgetOptions["canOpenHistory"];
-export type UICtx = {
-    setStatus(key: string, text: string | undefined): void;
-    setWidget(key: string, content: undefined | ((tui: any, theme: Theme) => {
-        render(): string[];
-        invalidate(): void;
-    }), options?: {
-        placement?: "aboveEditor" | "belowEditor";
-    }): void;
-    onTerminalInput?(handler: (data: string) => {
-        consume?: boolean;
-        data?: string;
-    } | undefined): () => void;
-    getEditorText?(): string;
-};
-/** Per-agent live activity state. */
-export interface AgentActivity {
-    activeTools: Map<string, string>;
-    toolUses: number;
-    responseText: string;
-    session?: SessionLike;
-    /** Current turn count. */
-    turnCount: number;
-    /** Effective max turns for this agent (undefined = unlimited). */
-    maxTurns?: number;
-    /** Lifetime usage breakdown — see LifetimeUsage docs. */
-    lifetimeUsage: LifetimeUsage;
-}
-/** Metadata attached to Agent tool results for custom rendering. */
-export interface AgentDetails {
-    displayName: string;
-    description: string;
-    subagentType: string;
-    toolUses: number;
-    tokens: string;
-    durationMs: number;
-    status: "queued" | "running" | "completed" | "steered" | "aborted" | "stopped" | "error" | "background";
-    /** Human-readable description of what the agent is currently doing. */
-    activity?: string;
-    /** Current spinner frame index (for animated running indicator). */
-    spinnerFrame?: number;
-    /** Short model name if different from parent (e.g. "haiku", "sonnet"). */
-    modelName?: string;
-    /** Notable config tags (e.g. ["thinking: high", "isolated"]). */
-    tags?: string[];
-    /** Current turn count. */
-    turnCount?: number;
-    /** Effective max turns (undefined = unlimited). */
-    maxTurns?: number;
-    /** Estimated cost in USD; 0 when the model has no pricing data. */
-    cost?: number;
-    agentId?: string;
-    error?: string;
-}
-/** Apply foreground styling while restoring it after nested foreground/full ANSI resets. */
-export declare function fgPreservingNestedStyles(theme: Theme, color: string, text: string): string;
-/** Format a token count compactly: "33.8k token", "1.2M token". */
-export declare function formatTokens(count: number): string;
-/**
- * Token count with optional context-fill % and compaction-count annotations.
- * Thresholds for percent: <70% dim, 70–85% warning, ≥85% error.
- * Compaction count rendered as `⇊N` in dim.
- *
- *   "12.3k token"               — no annotations
- *   "12.3k token (45%)"         — percent only
- *   "12.3k token (⇊2)"          — compactions only (e.g. right after compact)
- *   "12.3k token (45% · ⇊2)"    — both
- */
-export declare function formatSessionTokens(tokens: number, percent: number | null, theme: Theme, compactions?: number): string;
-/** Format turn count with optional max limit: "↻5≤30" or "↻5". */
-export declare function formatTurns(turnCount: number, maxTurns?: number | null): string;
-/** Format milliseconds as human-readable duration. */
-export declare function formatMs(ms: number): string;
-/** Format duration from start/completed timestamps. */
-export declare function formatDuration(startedAt: number, completedAt?: number): string;
-/** Format an estimated model cost without implying billing precision. */
-export declare function formatCost(cost: number): string;
-/** Get display name for any agent type (built-in or custom). */
-export declare function getDisplayName(type: SubagentType): string;
-/** Short label for prompt mode: "twin" for append, nothing for replace (the default). */
-export declare function getPromptModeLabel(type: SubagentType): string | undefined;
-/** Mode label is not included — callers add it where they want it. */
-export declare function buildInvocationTags(invocation: AgentInvocation | undefined): {
-    modelName?: string;
-    modelId?: string;
-    tags: string[];
-};
-/** Build a human-readable activity string from currently-running tools or response text. */
-export declare function describeActivity(activeTools: Map<string, string>, responseText?: string): string;
-export declare class AgentWidget {
-    private manager;
-    private agentActivity;
-    /** Read live at render time. Selects which agents the widget shows. */
-    private mode;
-    private uiCtx;
-    private widgetFrame;
-    private widgetInterval;
-    private inputUnsub;
-    /** Whether arrow keys currently navigate the agent roster. */
-    private navigationActive;
-    /** Stable identity of the selected row, so roster changes do not jump selection. */
-    private selectedAgentId;
-    /** Last logical roster index of the selected row, used when it disappears. */
-    private selectedRosterIndex;
-    /** First logical row currently represented by the bounded viewport. */
-    private viewportStart;
-    /** Cached records and roster. Rebuilt by update(), never by an arrow press. */
-    private cachedAgents;
-    private cachedRoster;
-    private rosterCacheKey;
-    private rosterCacheInitialized;
-    /** Terminal history capability is a potentially filesystem-backed lookup. */
-    private historyOpenabilityCache;
-    /** Whether the widget callback is currently registered with the TUI. */
-    private widgetRegistered;
-    /** Cached TUI reference from widget factory callback, used for requestRender(). */
-    private tui;
-    /** Last status bar text, used to avoid redundant setStatus calls. */
-    private lastStatusText;
-    /** Snapshot of the state used for the last widget registration/render request. */
-    private lastRenderKey;
-    private readonly openOptions;
-    private readonly showCost;
-    private readonly showModel;
-    constructor(manager: AgentManager, agentActivity: Map<string, AgentActivity>, 
-    /** Read live at render time. Selects which agents the widget shows. */
-    mode?: () => WidgetMode, showCostOrOptions?: (() => boolean) | AgentWidgetOptions, showModel?: () => boolean);
-    /**
-     * Agents eligible for the widget, per the current `WidgetMode`:
-     *   - `off`: none (the widget's existing empty-state path hides it entirely).
-     *   - `background`: drop only agents *known* to be foreground
-     *     (`isBackground === false`); keep everything else — background, queued,
-     *     scheduled, or RPC-spawned (`undefined`). Keying off the `isBackground`
-     *     record flag rather than the UI-only `invocation` snapshot (which only the
-     *     Agent-tool path sets), and excluding rather than allow-listing, means
-     *     only proven-foreground runs drop out — nothing else silently vanishes.
-     *   - `all`: every agent.
-     */
-    private widgetAgentsFromManager;
-    /** Records currently visible to the widget; safe for render and input paths. */
-    private widgetAgents;
-    private canOpenHistory;
-    private historyOpenabilityKey;
-    /**
-     * Cache terminal history capability by the record state that can affect it.
-     * The supplied predicate may call `existsSync`, so it must not run from a
-     * timer refresh, render-key calculation, or arrow-navigation path more than
-     * once for the same terminal record state.
-     */
-    private cachedCanOpenHistory;
-    /** Refresh the manager snapshot and openability cache at lifecycle/update time. */
-    private refreshRoster;
-    /** Set the UI context (grabbed from first tool execution). */
-    setUICtx(ctx: UICtx): boolean;
-    /** Request a render on the currently registered TUI without touching input. */
-    requestUiRefresh(force?: boolean): boolean;
-    /** Called on each new turn (tool_execution_start). */
-    onTurnStart(): void;
-    /** Keep the spinner/elapsed-time timer alive only while a visible agent runs. */
-    ensureTimer(): void;
-    private syncTimer;
-    /**
-     * Retained for the lifecycle call sites. Terminal visibility is determined
-     * by the manager record and the history capability, not a one-turn timer.
-     */
-    markFinished(_agentId: string): void;
-    /** Retained for lifecycle call sites; terminal rows are record-driven now. */
-    markRunning(_agentId: string): void;
-    /**
-     * Records represented by selectable rows in the above-editor widget.
-     *
-     * Keep this order as the single source of truth for both rendering and key
-     * navigation. `listAgents()` is newest-first; active rows come first so the
-     * panel exposes currently useful work before terminal history.
-     */
-    private roster;
-    /** True when pi's prompt editor owns the keyboard. */
-    private editorHasFocus;
-    private selectedIndexOf;
-    private deactivate;
-    /** Resume navigation from the retained row, or select the first row. */
-    private activate;
-    /** Move the selected row, activating only from an empty focused editor. */
-    private moveSelection;
-    private openSelected;
-    /** Handle terminal input before it reaches the focused prompt editor. */
-    handleKey(data: string): {
-        consume?: boolean;
-        data?: string;
-    } | undefined;
-    /** Render a finished agent line. */
-    private renderFinishedLine;
-    /**
-     * Render the widget content. Called from the registered widget's render() callback,
-     * reading live state each time instead of capturing it in a closure.
-     */
-    private renderWidget;
-    /** Build a render-relevant snapshot without capturing mutable records. */
-    private renderKey;
-    /** Force an immediate widget update. `advanceSpinner` is reserved for the timer. */
-    update(advanceSpinner?: boolean): void;
-    dispose(): void;
-}
-//# sourceMappingURL=agent-widget.d.ts.map

package/dist/ui/agent-widget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-widget.d.ts","sourceRoot":"","sources":["../../src/ui/agent-widget.ts"],"names":[],"mappings":"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"}