@hheei/pi-subagents 0.2.3 → 0.3.0

package/dist/session-fork.js

@@ -1,67 +0,0 @@
-import { readFile, stat } from "node:fs/promises";
-import { findSessionFile } from "./session-bootstrap.js";
-/** Reads all JSON entries from a session file on disk. */
-export async function readSessionJsonlEntries(sessionPath) {
-    const raw = await readFile(sessionPath, "utf8");
-    const lines = raw.split("\n").filter((line) => line.trim() !== "");
-    const entries = [];
-    for (const line of lines) {
-        try {
-            entries.push(JSON.parse(line));
-        }
-        catch {
-            // ignore trailing malformed line
-        }
-    }
-    return entries;
-}
-/**
- * Resolves the source session JSONL file path for on-demand context inspection.
- * Rejects 'current' to prevent ambiguous self-references.
- */
-export async function resolveForkSessionReference(options) {
-    const { forkFrom, parentSessionPath, registry } = options;
-    const target = forkFrom.trim();
-    if (target === "current") {
-        throw new Error("forkFrom cannot be 'current'. Use 'parent' to reference the parent session, or specify a subagent id like 'agent-1'.");
-    }
-    if (target === "parent" || target === "self") {
-        if (parentSessionPath !== undefined && parentSessionPath.trim() !== "") {
-            return parentSessionPath;
-        }
-        throw new Error("Parent session has no associated session file on disk to reference");
-    }
-    if (registry !== undefined) {
-        const record = await registry.get(target).catch(() => undefined);
-        if (record !== undefined) {
-            const subagentSessionPath = record.sessionPath ??
-                (await findSessionFile(record.launchConfig.sessionDir, record.sessionId));
-            if (subagentSessionPath !== undefined) {
-                return subagentSessionPath;
-            }
-            throw new Error(`Subagent ${target} has no session file on disk to reference`);
-        }
-        if (/^agent-\d+$/u.test(target)) {
-            throw new Error(`Subagent ${target} was not found in registry`);
-        }
-    }
-    // Treat as explicit session file path
-    try {
-        const st = await stat(target);
-        if (st.isFile())
-            return target;
-    }
-    catch {
-        // ignore
-    }
-    throw new Error(`Referenced session file not found: ${target}`);
-}
-/** Formats instructions explaining where the referenced session file is and how to inspect it on demand. */
-export function formatSessionReferencePrompt(sessionPath) {
-    return [
-        "## Referenced Session Context",
-        "Prior session transcript is available for reference at:",
-        sessionPath,
-        "Use tools (such as read or grep) to inspect earlier messages, tool outputs, or context from this JSONL file on demand as needed instead of loading the entire history.",
-    ].join("\n");
-}

package/dist/widget.d.ts

@@ -1,12 +0,0 @@
-import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
-import { type PublicSubagent, type SubagentState } from "./domain.js";
-export declare const SUBAGENT_TERMINAL_DISPLAY_DURATION_MS = 15000;
-export interface SubagentWidget {
-    refresh(children: readonly PublicSubagent[]): void;
-    dispose(): void;
-}
-export declare function isTerminalState(state: SubagentState): boolean;
-export declare function isWidgetVisibleChild(child: PublicSubagent, nowMs?: number): boolean;
-export declare function formatElapsed(fromIso: string, nowMs?: number): string;
-export declare function renderSubagentWidget(children: readonly PublicSubagent[], width: number, theme: Theme, nowMs?: number): string[];
-export declare function createSubagentWidget(pi: ExtensionAPI, context: ExtensionContext, signal: AbortSignal, initial?: readonly PublicSubagent[]): SubagentWidget | undefined;

package/dist/widget.js

@@ -1,149 +0,0 @@
-import { truncateToWidth } from "@earendil-works/pi-tui";
-import { registerWidget } from "@hheei/pi-ext-core";
-import { toVisualSubagentState, VISUAL_SUBAGENT_GLYPH, VISUAL_SUBAGENT_TONE, } from "./domain.js";
-const WIDGET_ID = "@hheei/pi-subagents:status";
-const MAX_ROWS = 8;
-const ELAPSED_TICK_MS = 1_000;
-export const SUBAGENT_TERMINAL_DISPLAY_DURATION_MS = 15_000;
-export function isTerminalState(state) {
-    return state === "done" || state === "blocked" || state === "error";
-}
-export function isWidgetVisibleChild(child, nowMs = Date.now()) {
-    const visual = toVisualSubagentState(child.state, child.interrupted);
-    if (visual === "running") {
-        return true;
-    }
-    const updated = Date.parse(child.updatedAt);
-    if (!Number.isNaN(updated) && nowMs - updated < SUBAGENT_TERMINAL_DISPLAY_DURATION_MS) {
-        return true;
-    }
-    return false;
-}
-function visibleChildren(children, nowMs = Date.now()) {
-    return children.filter((c) => isWidgetVisibleChild(c, nowMs));
-}
-export function formatElapsed(fromIso, nowMs = Date.now()) {
-    const from = Date.parse(fromIso);
-    if (Number.isNaN(from))
-        return "";
-    const totalSeconds = Math.max(0, Math.floor((nowMs - from) / 1000));
-    if (totalSeconds < 60)
-        return `${totalSeconds}s`;
-    const hours = Math.floor(totalSeconds / 3600);
-    const minutes = Math.floor((totalSeconds % 3600) / 60);
-    const seconds = totalSeconds % 60;
-    if (hours > 0)
-        return `${hours}h ${minutes}m`;
-    return `${minutes}m ${seconds}s`;
-}
-export function renderSubagentWidget(children, width, theme, nowMs = Date.now()) {
-    const visible = visibleChildren(children, nowMs);
-    if (visible.length === 0)
-        return [];
-    const heading = `🤖 ${theme.fg("text", "Agents:")}`;
-    const lines = [truncateToWidth(heading, width, theme.fg("dim", "…"))];
-    const rows = visible.slice(0, MAX_ROWS);
-    const sep = theme.fg("dim", " · ");
-    for (let index = 0; index < rows.length; index++) {
-        const child = rows[index];
-        if (child === undefined)
-            continue;
-        const visual = toVisualSubagentState(child.state, child.interrupted);
-        const glyph = VISUAL_SUBAGENT_GLYPH[visual];
-        const tone = VISUAL_SUBAGENT_TONE[visual];
-        const glyphStyled = theme.fg(tone, glyph);
-        const idStyled = theme.fg("dim", `#${child.id}`);
-        const nameStyled = theme.fg("text", child.displayName ?? child.agent);
-        const elapsed = formatElapsed(child.createdAt, nowMs);
-        const timeStyled = theme.fg("dim", elapsed === "" ? "0s" : elapsed);
-        const stateStyled = theme.fg(tone, visual);
-        const turnsCount = child.usage?.turns ?? 0;
-        const turnsLabel = `${turnsCount} turn${turnsCount === 1 ? "" : "s"}`;
-        const turnsStyled = theme.fg("dim", turnsLabel);
-        let detailText = "";
-        if (child.activeTool !== undefined && child.activeTool.trim() !== "") {
-            detailText = child.activeTool.trim();
-        }
-        else if (child.summary !== undefined && child.summary.trim() !== "") {
-            detailText = child.summary.replace(/\s+/g, " ").trim();
-        }
-        const detailStyled = detailText === "" ? "" : `${sep}${theme.fg("dim", detailText)}`;
-        const rowContent = `${glyphStyled} ${idStyled} ${nameStyled}${sep}${timeStyled}${sep}${stateStyled}${sep}${turnsStyled}${detailStyled}`;
-        lines.push(truncateToWidth(rowContent, width, theme.fg("dim", "…")));
-    }
-    if (visible.length > MAX_ROWS) {
-        lines.push(truncateToWidth(theme.fg("dim", `+${visible.length - MAX_ROWS} more`), width, theme.fg("dim", "…")));
-    }
-    lines.push("");
-    return lines;
-}
-export function createSubagentWidget(pi, context, signal, initial = []) {
-    if (context.mode !== "tui")
-        return undefined;
-    let children = initial;
-    let disposed = false;
-    let tick;
-    const hasRows = () => visibleChildren(children).length > 0;
-    const widget = registerWidget(pi, context, signal, {
-        id: WIDGET_ID,
-        placement: "aboveEditor",
-        visible: hasRows(),
-        create: (_tui, theme) => ({
-            render: (width) => renderSubagentWidget(children, width, theme),
-            invalidate: () => undefined,
-            dispose: () => undefined,
-        }),
-    });
-    const stopTick = () => {
-        if (tick === undefined)
-            return;
-        clearInterval(tick);
-        tick = undefined;
-    };
-    const syncTick = () => {
-        if (disposed || !hasRows()) {
-            stopTick();
-            return;
-        }
-        // 仅在有进行中任务或待淡出任务时维持 tick，纯 idle 时静默
-        const hasActiveOrExpiring = children.some((child) => isWidgetVisibleChild(child));
-        if (!hasActiveOrExpiring) {
-            stopTick();
-            return;
-        }
-        if (tick !== undefined)
-            return;
-        tick = setInterval(() => {
-            if (!hasRows()) {
-                widget.setVisible(false);
-                stopTick();
-            }
-            else {
-                widget.requestRender();
-            }
-        }, ELAPSED_TICK_MS);
-    };
-    syncTick();
-    signal.addEventListener("abort", stopTick, { once: true });
-    return {
-        refresh(next) {
-            if (disposed)
-                return;
-            children = next;
-            if (!hasRows())
-                widget.setVisible(false);
-            else {
-                widget.setVisible(true);
-                widget.requestRender();
-            }
-            syncTick();
-        },
-        dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            stopTick();
-            widget.dispose();
-        },
-    };
-}