@pinet/agent-goal 0.2.6 → 0.2.7

package/README.md

@@ -20,7 +20,7 @@ pi -e ./agent-goal/index.ts
 
 ```text
 /goal <objective>  Create and immediately start a goal
-/goal              Inspect this session's goal
+/goal              Open the minimal goal window (text in headless modes)
 /goal pause        Pause automatic evaluation and continuation
 /goal resume       Resume and immediately continue
 /goal complete     Mark complete manually
@@ -29,7 +29,7 @@ pi -e ./agent-goal/index.ts
 /goal show         Show the persistent goal dashboard
 ```
 
-Pi's footer shows the status and budget usage. A compact widget below the editor shows the objective, turns, tokens, last evaluator decision, continuation state, and available commands. `/goal` remains a textual fallback in headless sessions.
+Pi's footer shows the status and budget usage. A compact widget below the editor shows passive progress. In interactive mode, `/goal` opens a centered, keyboard-dismissable window with the objective, lifecycle state, budget bars, latest evaluator guidance, and continuation state. Press Escape, Enter, `q`, or Ctrl+C to close it. `/goal` remains a textual fallback in headless sessions.
 
 Only one goal may exist per Pi session. Clear the existing goal before creating another.
 

package/dist/dashboard.d.ts

@@ -1,3 +1,4 @@
 import type { AgentGoal, GoalContinuationClaim } from "./domain.js";
+export declare function displayGoalText(value: string, maxLength: number): string;
 export declare function formatGoalStatus(goal: AgentGoal): string;
 export declare function formatGoalDashboard(goal: AgentGoal, claim?: GoalContinuationClaim): string[];

package/dist/dashboard.js

@@ -1,4 +1,4 @@
-function displayText(value, maxLength) {
+export function displayGoalText(value, maxLength) {
     const normalized = value
         .replaceAll("\n", " ")
         .replaceAll("\r", " ")
@@ -27,14 +27,14 @@ export function formatGoalDashboard(goal, claim) {
         .join(" · ");
     const lines = [
         `Goal · ${goal.status} · v${goal.version}`,
-        displayText(goal.objective, 120),
+        displayGoalText(goal.objective, 120),
         usage,
     ];
     if (goal.lastEvaluation) {
-        lines.push(`Last ${goal.lastEvaluation.outcome.toUpperCase()}: ${displayText(goal.lastEvaluation.reason, 100)}`);
+        lines.push(`Last ${goal.lastEvaluation.outcome.toUpperCase()}: ${displayGoalText(goal.lastEvaluation.reason, 100)}`);
     }
     if (goal.blockedReason)
-        lines.push(`Reason: ${displayText(goal.blockedReason, 100)}`);
+        lines.push(`Reason: ${displayGoalText(goal.blockedReason, 100)}`);
     if (claim)
         lines.push(`Continuation: ${claim.state} · attempt ${claim.attempt}`);
     lines.push("/goal pause · resume · complete · clear · hide");

package/dist/goal-window.d.ts

@@ -0,0 +1,14 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type Component } from "@earendil-works/pi-tui";
+import type { AgentGoal, GoalContinuationClaim } from "./domain.js";
+export declare class GoalWindow implements Component {
+    private readonly goal;
+    private readonly claim;
+    private readonly theme;
+    private readonly onClose;
+    private readonly now;
+    constructor(goal: AgentGoal | undefined, claim: GoalContinuationClaim | undefined, theme: Theme, onClose: () => void, now?: () => number);
+    handleInput(data: string): void;
+    render(width: number): string[];
+    invalidate(): void;
+}

package/dist/goal-window.js

@@ -0,0 +1,101 @@
+import { matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
+import { displayGoalText } from "./dashboard.js";
+function progressBar(value, maximum, width) {
+    const ratio = Math.min(1, Math.max(0, value / maximum));
+    const filled = Math.round(ratio * width);
+    return `${"━".repeat(filled)}${"─".repeat(width - filled)}`;
+}
+function compactNumber(value) {
+    if (value < 1_000)
+        return String(value);
+    const divisor = value < 1_000_000 ? 1_000 : 1_000_000;
+    const suffix = value < 1_000_000 ? "k" : "m";
+    const scaled = value / divisor;
+    return `${scaled.toFixed(scaled < 100 ? 1 : 0).replace(/\.0$/, "")}${suffix}`;
+}
+export class GoalWindow {
+    goal;
+    claim;
+    theme;
+    onClose;
+    now;
+    constructor(goal, claim, theme, onClose, now = Date.now) {
+        this.goal = goal;
+        this.claim = claim;
+        this.theme = theme;
+        this.onClose = onClose;
+        this.now = now;
+    }
+    handleInput(data) {
+        if (matchesKey(data, "escape") ||
+            matchesKey(data, "ctrl+c") ||
+            matchesKey(data, "return") ||
+            data.toLowerCase() === "q") {
+            this.onClose();
+        }
+    }
+    render(width) {
+        if (width < 8)
+            return [truncateToWidth("Goal", Math.max(0, width), "")];
+        const innerWidth = width - 2;
+        const contentWidth = Math.max(1, innerWidth - 2);
+        const borderColor = this.goal?.status === "complete" ? "success" : "borderAccent";
+        const border = (text) => this.theme.fg(borderColor, text);
+        const row = (content = "") => {
+            const truncated = truncateToWidth(content, innerWidth, "", true);
+            return `${border("│")}${truncated}${" ".repeat(Math.max(0, innerWidth - visibleWidth(truncated)))}${border("│")}`;
+        };
+        const title = this.theme.fg("accent", this.theme.bold(" Goal "));
+        const titleWidth = visibleWidth(title);
+        const lines = [
+            `${border("╭")}${title}${border(`${"─".repeat(Math.max(0, innerWidth - titleWidth))}╮`)}`,
+        ];
+        if (!this.goal) {
+            lines.push(row(), row(` ${this.theme.fg("muted", "No goal for this session.")}`));
+            lines.push(row(` ${this.theme.fg("dim", "/goal <objective> to begin")}`), row());
+            lines.push(row(` ${this.theme.fg("dim", "esc · enter · q  close")}`));
+            lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
+            return lines;
+        }
+        const statusColor = this.goal.status === "complete"
+            ? "success"
+            : this.goal.status === "blocked"
+                ? "error"
+                : this.goal.status === "active"
+                    ? "accent"
+                    : "warning";
+        lines.push(row(` ${this.theme.fg(statusColor, `● ${this.goal.status.toUpperCase()}`)}`));
+        const objectiveLines = wrapTextWithAnsi(displayGoalText(this.goal.objective, 500), contentWidth).slice(0, 3);
+        for (const objectiveLine of objectiveLines)
+            lines.push(row(` ${objectiveLine}`));
+        lines.push(row());
+        const turnBar = progressBar(this.goal.usage.iterations, this.goal.budget.maxIterations, Math.min(12, Math.max(4, contentWidth - 23)));
+        lines.push(row(` Turns  ${this.theme.fg("accent", turnBar)}  ${this.goal.usage.iterations}/${this.goal.budget.maxIterations}`));
+        if (this.goal.budget.maxTokens === undefined) {
+            lines.push(row(` Tokens ${compactNumber(this.goal.usage.tokens)}`));
+        }
+        else {
+            const tokenBar = progressBar(this.goal.usage.tokens, this.goal.budget.maxTokens, Math.min(12, Math.max(4, contentWidth - 23)));
+            lines.push(row(` Tokens ${this.theme.fg("accent", tokenBar)}  ${compactNumber(this.goal.usage.tokens)}/${compactNumber(this.goal.budget.maxTokens)}`));
+        }
+        if (this.goal.budget.maxRuntimeMs !== undefined) {
+            const end = this.goal.status === "active" ? this.now() : Date.parse(this.goal.updatedAt);
+            const elapsed = Math.max(0, end - Date.parse(this.goal.createdAt));
+            const runtimeBar = progressBar(elapsed, this.goal.budget.maxRuntimeMs, Math.min(12, Math.max(4, contentWidth - 23)));
+            lines.push(row(` Time   ${this.theme.fg("accent", runtimeBar)}  ${Math.floor(elapsed / 60_000)}m/${Math.ceil(this.goal.budget.maxRuntimeMs / 60_000)}m`));
+        }
+        if (this.goal.lastEvaluation) {
+            lines.push(row(), row(` ${this.theme.fg("muted", "Latest")} ${displayGoalText(this.goal.lastEvaluation.reason, Math.max(20, contentWidth - 8))}`));
+        }
+        else if (this.goal.blockedReason) {
+            lines.push(row(), row(` ${this.theme.fg("muted", "Reason")} ${displayGoalText(this.goal.blockedReason, Math.max(20, contentWidth - 8))}`));
+        }
+        if (this.claim) {
+            lines.push(row(` ${this.theme.fg("muted", "Continuation")} ${this.claim.state} · attempt ${this.claim.attempt}`));
+        }
+        lines.push(row(), row(` ${this.theme.fg("dim", "esc · enter · q  close")}`));
+        lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
+        return lines;
+    }
+    invalidate() { }
+}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { GoalBudget, GoalContinuation, GoalEvaluator, GoalEventSink, GoalRetryPolicy, GoalStorage, GoalWakeScheduler } from "./domain.js";
 export type { AgentGoal, GoalBudget, GoalContinuation, GoalContinuationClaim, GoalContinuationRequest, GoalContinuationResult, GoalEvaluation, GoalEvaluationRecord, GoalEvaluator, GoalEvent, GoalEventSink, GoalPendingEvaluation, GoalProgress, GoalRetryPolicy, GoalStatus, GoalStorage, GoalTerminalCandidate, GoalTerminalCandidateRecord, GoalUsage, GoalWakeScheduler, } from "./domain.js";
-export { formatGoalDashboard, formatGoalStatus } from "./dashboard.js";
+export { displayGoalText, formatGoalDashboard, formatGoalStatus } from "./dashboard.js";
+export { GoalWindow } from "./goal-window.js";
 export { MemoryGoalStorage } from "./memory-storage.js";
 export { parseGoalEvaluation, PiGoalEvaluator } from "./pi-evaluator.js";
 export { countGoalProgressTokens, formatGoalProgress, type GoalProgressMessage, } from "./progress.js";

package/dist/index.js

@@ -1,11 +1,13 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { formatGoalDashboard, formatGoalStatus } from "./dashboard.js";
+import { GoalWindow } from "./goal-window.js";
 import { PiGoalEvaluator } from "./pi-evaluator.js";
 import { countGoalProgressTokens, formatGoalProgress, } from "./progress.js";
 import { GoalRuntime } from "./runtime.js";
 import { SqliteGoalStorage } from "./sqlite-storage.js";
-export { formatGoalDashboard, formatGoalStatus } from "./dashboard.js";
+export { displayGoalText, formatGoalDashboard, formatGoalStatus } from "./dashboard.js";
+export { GoalWindow } from "./goal-window.js";
 export { MemoryGoalStorage } from "./memory-storage.js";
 export { parseGoalEvaluation, PiGoalEvaluator } from "./pi-evaluator.js";
 export { countGoalProgressTokens, formatGoalProgress, } from "./progress.js";
@@ -283,6 +285,22 @@ export function registerAgentGoal(pi, options = {}) {
                 if (!input) {
                     const goal = await runtime.get(scopeId);
                     const claim = await runtime.getContinuationClaim(scopeId);
+                    let openedWindow = false;
+                    await ctx.ui.custom((_tui, theme, _keybindings, done) => {
+                        openedWindow = true;
+                        return new GoalWindow(goal, claim, theme, () => done(undefined));
+                    }, {
+                        overlay: true,
+                        overlayOptions: {
+                            anchor: "center",
+                            width: 66,
+                            minWidth: 36,
+                            maxHeight: "80%",
+                            margin: 1,
+                        },
+                    });
+                    if (openedWindow)
+                        return;
                     api.sendMessage({
                         customType: "agent-goal.status",
                         content: goal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinet/agent-goal",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "type": "module",
   "description": "Standalone single-agent durable goal loop for Pi",
   "author": "Will Porcellini <5994936+gugu91@users.noreply.github.com>",
@@ -48,6 +48,7 @@
   "dependencies": {},
   "peerDependencies": {
     "@earendil-works/pi-ai": ">=0.74.0",
-    "@earendil-works/pi-coding-agent": ">=0.74.0"
+    "@earendil-works/pi-coding-agent": ">=0.74.0",
+    "@earendil-works/pi-tui": ">=0.74.0"
   }
 }