@entelligentsia/forgecli 1.0.14 → 1.0.21

package/dist/extensions/forgecli/viewport/events.js

@@ -0,0 +1,290 @@
+// viewport/events.ts
+//
+// Reusable subagent event observer. Wires `runForgeSubagent.onEvent` to:
+//   1. Append per-event tail lines (with tree connectors, glyphs, risky tag,
+//      thinking one-liners, batch markers) into SessionRegistry.
+//   2. Maintain cumulative phase token usage and push it to the registry on
+//      every turn_end — drives the sticky footer in the tail view AND the
+//      aggregate Σ meter in the chip strip.
+//   3. Surface counts (turn / tools / errors) so the orchestrator can render
+//      its end-of-phase summary.
+//
+// Used by run-task, fix-bug, and run-sprint (ceremony) so every subagent
+// "bubbles" usage up the same way. Top-level viewports read aggregate usage
+// via SessionRegistry.getAggregateUsage().
+import * as fs from "node:fs";
+import { getOrchestratorTree } from "../orchestrator-tree.js";
+import { argContent as fmtArgContent, extractThinkingOneLiner, extractTurnPreview, argHint as fmtArgHint, RISKY_TAG, readUsage, resultShape, toolGlyph, } from "./renderer.js";
+function extractCompression(result) {
+    if (!result || typeof result !== "object")
+        return undefined;
+    const r = result;
+    const c = r.details?.compression;
+    if (!c || typeof c.before !== "number" || typeof c.after !== "number")
+        return undefined;
+    return { tool: c.tool ?? "", before: c.before, after: c.after, saved: c.saved ?? 0 };
+}
+/**
+ * Head-preserving cap on the recorded tail log. Live phases rarely exceed a
+ * few hundred lines; the cap only bounds pathological runs. Head-preserving
+ * (stop recording, don't drop oldest) because the log's consumer is the
+ * transcript-archive REPLAY, where the beginning is the valuable part.
+ */
+export const TAIL_LOG_CAP = 5000;
+/**
+ * Persist the recorded tail log next to its phase transcript as JSONL
+ * (`<transcript-base>.tail.jsonl`). The transcript archive sweeps it with
+ * the run; replay re-reads the exact lines the live dashboard showed.
+ * Best-effort — observability data, never throws.
+ */
+export function persistTailLog(subagentTranscriptPath, tailLog) {
+    if (!subagentTranscriptPath.endsWith(".json") || tailLog.length === 0)
+        return null;
+    try {
+        const outPath = `${subagentTranscriptPath.slice(0, -".json".length)}.tail.jsonl`;
+        fs.writeFileSync(outPath, `${tailLog.map((e) => JSON.stringify(e)).join("\n")}\n`, "utf8");
+        return outPath;
+    }
+    catch {
+        return null;
+    }
+}
+export function attachViewportObserver(opts) {
+    const { registry, sessionId, phaseRole, displayRole, beginHeader, writeDebug, setStatusVerbose, notify, verboseKeys, afterEach, nodeId: pinnedNodeId, } = opts;
+    const role = displayRole ?? phaseRole;
+    const tree = getOrchestratorTree();
+    // Helper to resolve the correct active node ID in the OrchestratorTree.
+    // When the caller pins the dispatch node, attribution is fixed — never
+    // re-resolved by scan (node-per-dispatch contract). The scan below is the
+    // legacy fallback for callers that don't pass nodeId.
+    const resolveNodeId = () => {
+        if (pinnedNodeId)
+            return pinnedNodeId;
+        const exactId = `${sessionId}:${phaseRole}`;
+        const exactNode = tree.getNode(exactId);
+        if (exactNode && exactNode.status === "running")
+            return exactId;
+        const parentNode = tree.getNode(sessionId);
+        if (parentNode) {
+            const prefix = `${sessionId}:${phaseRole}:`;
+            for (const cid of parentNode.children) {
+                if (cid.startsWith(prefix)) {
+                    const child = tree.getNode(cid);
+                    if (child && child.status === "running") {
+                        return cid;
+                    }
+                }
+            }
+        }
+        return exactId;
+    };
+    const state = {
+        turn: 0,
+        toolCount: 0,
+        errCount: 0,
+        lastTool: "",
+        cumUsage: { input: 0, output: 0, cacheRead: 0 },
+        cumCompression: { calls: 0, tokensSaved: 0 },
+        tailLog: [],
+    };
+    // Per-turn tree-connector state.
+    let toolsThisTurn = 0;
+    let firstLineOfTurn = true;
+    const argsByCallId = new Map();
+    const formatTime = (ms) => {
+        const d = new Date(ms);
+        const pad = (n) => String(n).padStart(2, "0");
+        return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+    };
+    // Compact turn stamp. No phase/role prefix — the tail renders inside a
+    // phase-scoped context (dashboard node / phase tail view), so repeating
+    // the role on every turn wastes log width.
+    const tailPrefix = () => `[T${state.turn}:${formatTime(Date.now())}]`;
+    const appendTail = (line, opts) => {
+        registry.appendTail(sessionId, phaseRole, line, opts);
+        tree.appendTail(resolveNodeId(), line, opts);
+        // Record the exact rendered line for post-run persistence (replay).
+        if (state.tailLog.length < TAIL_LOG_CAP) {
+            state.tailLog.push(opts?.warning ? { line, warning: true } : { line });
+        }
+        else if (state.tailLog.length === TAIL_LOG_CAP) {
+            state.tailLog.push({ line: `… tail log capped at ${TAIL_LOG_CAP} lines` });
+        }
+    };
+    const rawErrorText = (result) => typeof result === "string"
+        ? result
+        : typeof result === "object" && result !== null
+            ? JSON.stringify(result)
+            : String(result);
+    // Short form for single-line UI surfaces (status/notify); the activity-log
+    // entry carries the full error — clamping is the view's decision.
+    const extractErrorSummary = (result) => {
+        const raw = rawErrorText(result);
+        const firstLine = raw.split(/\r?\n/).find((l) => l.trim().length > 0) ?? raw;
+        return firstLine.length > 160 ? `${firstLine.slice(0, 160)}…` : firstLine;
+    };
+    // Turn grouping: bracket glyphs flush left on every line; the compact turn
+    // stamp rides inside the first line. No left margin on continuation lines —
+    // the full pane width carries log content.
+    //   ╭ [T18:06:44:22] $ bash …
+    //   │ ← bash ok 29L
+    //   ╰ » "next step …"
+    const emitTurnLine = (body, lineOpts) => {
+        const isFirst = firstLineOfTurn;
+        const isClosing = lineOpts?.closing === true;
+        let branch;
+        if (isFirst && isClosing)
+            branch = "─";
+        else if (isFirst)
+            branch = "╭";
+        else if (isClosing)
+            branch = "╰";
+        else
+            branch = "│";
+        const stamp = isFirst ? ` ${tailPrefix()}` : "";
+        firstLineOfTurn = false;
+        appendTail(`${branch}${stamp} ${body}`, lineOpts?.warning ? { warning: true } : undefined);
+    };
+    if (beginHeader)
+        appendTail(`${tailPrefix()} ${beginHeader}`);
+    const onEvent = (event) => {
+        switch (event.type) {
+            case "turn_start": {
+                state.turn++;
+                state.lastTool = "";
+                toolsThisTurn = 0;
+                firstLineOfTurn = true;
+                registry.bumpTurn(sessionId);
+                tree.bumpNodeTurn(resolveNodeId());
+                break;
+            }
+            case "turn_end": {
+                const e = event;
+                const delta = readUsage(e.message);
+                state.cumUsage.input += delta.input;
+                state.cumUsage.output += delta.output;
+                state.cumUsage.cacheRead += delta.cacheRead;
+                registry.setPhaseUsage(sessionId, phaseRole, state.cumUsage);
+                const nodeId = resolveNodeId();
+                tree.setNodeUsage(nodeId, state.cumUsage);
+                // Capture which (provider, model) actually served this turn so
+                // the per-phase tail-view footer can display it. Cheap; the
+                // registry no-ops when the value hasn't changed.
+                const msg = e.message;
+                if (msg && (msg.provider || msg.model)) {
+                    registry.setPhaseModel(sessionId, phaseRole, {
+                        provider: msg.provider,
+                        model: msg.model,
+                    });
+                    tree.setNodeModel(nodeId, msg.model ?? "", msg.provider ?? "");
+                }
+                const closingBodies = [];
+                const thinking = extractThinkingOneLiner(e.message);
+                if (thinking)
+                    closingBodies.push(`✱ ${thinking}`);
+                const preview = extractTurnPreview(e.message);
+                if (preview) {
+                    registry.setTurnPreview(sessionId, preview);
+                    tree.setTurnPreview(nodeId, preview);
+                    if (setStatusVerbose && verboseKeys?.messageKey) {
+                        setStatusVerbose(verboseKeys.messageKey, `  "${preview}"`);
+                    }
+                    closingBodies.push(`» "${preview}"`);
+                }
+                if (toolsThisTurn > 1) {
+                    closingBodies.push(`⇉ batched ${toolsThisTurn} tool calls in turn ${state.turn}`);
+                }
+                for (let i = 0; i < closingBodies.length; i++) {
+                    const isLast = i === closingBodies.length - 1;
+                    emitTurnLine(closingBodies[i], { closing: isLast });
+                }
+                // Bubble one consolidated event up to the registry so the
+                // top-level viewport can surface activity from any subagent
+                // with subagent-identified attribution.
+                registry.recordTurnEvent({
+                    sessionId,
+                    phaseRole,
+                    displayRole: role,
+                    turn: state.turn,
+                    preview: preview ?? "",
+                    thinking: thinking ?? "",
+                    deltaUsage: { ...delta },
+                    cumUsage: { ...state.cumUsage },
+                    timestamp: Date.now(),
+                });
+                break;
+            }
+            case "tool_execution_start": {
+                const e = event;
+                state.toolCount++;
+                toolsThisTurn++;
+                argsByCallId.set(e.toolCallId, e.args);
+                // Status line gets a short hint (single-line UI constraint of
+                // setStatus); the activity-log entry carries the FULL argument
+                // content — display clamping/expansion is the view's decision.
+                const hint = fmtArgHint(e.toolName, e.args);
+                const content = fmtArgContent(e.toolName, e.args);
+                const { glyph, risky } = toolGlyph(e.toolName, e.args);
+                state.lastTool = `${e.toolName}${hint ? ` ${hint}` : ""}`;
+                writeDebug?.({
+                    kind: "tool_start",
+                    toolName: e.toolName,
+                    toolCallId: e.toolCallId,
+                    args: e.args,
+                });
+                registry.recordToolStart(sessionId, e.toolCallId, e.toolName, e.args);
+                tree.incrementNodeToolCount(resolveNodeId());
+                const riskPrefix = risky ? `${RISKY_TAG} ` : "";
+                emitTurnLine(`${riskPrefix}${glyph} ${e.toolName}${content ? ` ${content}` : ""}`, risky ? { warning: true } : undefined);
+                break;
+            }
+            case "tool_execution_end": {
+                const e = event;
+                argsByCallId.delete(e.toolCallId);
+                writeDebug?.({
+                    kind: "tool_end",
+                    toolName: e.toolName,
+                    toolCallId: e.toolCallId,
+                    isError: e.isError,
+                    result: e.result,
+                });
+                registry.recordToolEnd(sessionId, e.toolCallId, e.toolName, e.isError, e.result);
+                const nodeId = resolveNodeId();
+                if (e.isError) {
+                    state.errCount++;
+                    tree.incrementNodeErrCount(nodeId);
+                    emitTurnLine(`⚠ ${e.toolName} failed: ${rawErrorText(e.result)}`, { warning: true });
+                }
+                else {
+                    const shape = resultShape(e.toolName, e.result);
+                    const comp = extractCompression(e.result);
+                    const compHint = comp ? ` ⇌${comp.saved}%` : "";
+                    emitTurnLine(`← ${e.toolName} ok${shape ? ` ${shape}` : ""}${compHint}`);
+                    if (comp) {
+                        state.cumCompression.calls++;
+                        state.cumCompression.tokensSaved += comp.before - comp.after;
+                        registry.setPhaseCompression(sessionId, phaseRole, state.cumCompression);
+                        tree.setNodeCompression(nodeId, state.cumCompression);
+                    }
+                }
+                break;
+            }
+            case "compaction_start": {
+                const e = event;
+                notify?.(`◌ ${role}: context compacting (${e.reason})…`, "info");
+                appendTail(`${tailPrefix()} ◌ compacting (${e.reason})`);
+                break;
+            }
+            case "auto_retry_start": {
+                const e = event;
+                const err = e.errorMessage ?? "";
+                notify?.(`↻ ${role}: model retry ${e.attempt}/${e.maxAttempts}${err ? `\n${err}` : ""}`, "warning");
+                appendTail(`${tailPrefix()} ↻ retry ${e.attempt}/${e.maxAttempts}${err ? `: ${extractErrorSummary(err)}` : ""}`, { warning: true });
+                break;
+            }
+        }
+        afterEach?.();
+    };
+    return { onEvent, state };
+}
+//# sourceMappingURL=events.js.map

package/dist/extensions/forgecli/viewport/events.js.map

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

package/dist/extensions/forgecli/viewport/renderer.d.ts

@@ -0,0 +1,102 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+export declare const RISKY_TAG = "\uD83D\uDD12";
+export interface GlyphInfo {
+    glyph: string;
+    risky: boolean;
+}
+export declare function toolGlyph(toolName: string, args: unknown): GlyphInfo;
+export declare function argHint(toolName: string, args: unknown, maxLen?: number): string;
+/**
+ * Full argument content for the activity log — the producer plays no display
+ * role: the log entry carries the complete command/pattern/query (newlines
+ * and all) and the VIEWS decide how to clamp, wrap, or expand it (dashboard:
+ * 2-row clamp + ctrl+o expand). Paths stay full (not basenamed) — same
+ * principle.
+ */
+export declare function argContent(toolName: string, args: unknown): string;
+/**
+ * View-side display normalization: split a raw log entry (stored verbatim in
+ * the tail buffers) into display-safe lines — split on any line-break flavour,
+ * expand tabs (tabs break visible-width column math), strip layout-breaking C0
+ * control characters while preserving ANSI styling (\x1b). Blank continuation
+ * segments are dropped; fully-empty input stays one empty line. Every view
+ * that renders tail entries into a row-based layout MUST route them through
+ * this (a raw \n inside a composed pane row resets the terminal cursor to
+ * column 0 and the remainder renders under the adjacent pane).
+ */
+export declare function toDisplayLines(raw: string): string[];
+/**
+ * Truncate at a whitespace boundary when possible so we don't slice mid-token
+ * (e.g. `FORGE_ROOT=$(node -e` cut at the open paren). Appends `…(+Nc)` so the
+ * user knows there's more.
+ */
+export declare function truncateAtBoundary(s: string, max: number): string;
+/**
+ * Extract a small "shape" hint from a tool result so users see `read ok 247L`
+ * instead of `read ok`. Defensive: result shapes vary across tools and providers.
+ */
+export declare function resultShape(_toolName: string, result: unknown): string;
+/**
+ * Pull the first sentence (or first 100 chars) from any `thinking` block on an
+ * assistant message. Returns `undefined` if no thinking content present.
+ */
+export declare function extractThinkingOneLiner(message: AgentMessage | undefined): string | undefined;
+export interface UsageDelta {
+    input: number;
+    output: number;
+    cacheRead: number;
+}
+/** Extract usage from an assistant message; returns zeros if missing. */
+export declare function readUsage(message: AgentMessage | undefined): UsageDelta;
+/**
+ * Extract the last assistant-authored text from a turn_end message and
+ * collapse to a single-line preview (max 120 chars). Returns "" if the
+ * message has no text content (e.g. all-tool-call turn).
+ */
+export declare function extractTurnPreview(message: unknown): string;
+export declare function fmtTokenMeter(u: UsageDelta): string;
+/** Format a one-shot phase-completion line for the tail buffer. */
+export declare function fmtPhaseSummary(opts: {
+    role: string;
+    turns: number;
+    tools: number;
+    errors: number;
+    wallSeconds: number;
+    usage: UsageDelta;
+    model?: string;
+    provider?: string;
+    compression?: {
+        calls: number;
+        tokensSaved: number;
+    };
+}): string;
+/**
+ * Build the sticky footer line shown at the bottom of the tail view.
+ * Includes cacheRead only when nonzero — most non-Anthropic providers (ollama,
+ * glm, etc.) return 0 for cache fields and we don't want the noise.
+ */
+export declare function fmtTokenFooter(usage: UsageDelta | undefined, compression?: {
+    calls: number;
+    tokensSaved: number;
+}): string;
+/**
+ * Compact `(provider) model` label used to annotate token footers so users
+ * can see which model a phase ran with. Returns "" when neither field is
+ * populated.
+ */
+export declare function fmtModelLabel(info: {
+    provider?: string;
+    model?: string;
+} | undefined): string;
+/**
+ * Combine a model label with a token footer, separated by ` · `. Either
+ * half may be empty — the separator is only inserted when both halves are
+ * present. Returns "" when both are empty.
+ */
+export declare function fmtModelAndTokenFooter(info: {
+    provider?: string;
+    model?: string;
+} | undefined, usage: UsageDelta | undefined, compression?: {
+    calls: number;
+    tokensSaved: number;
+}): string;