@pinet/agent-goal 0.2.8 → 0.2.9

package/README.md

@@ -25,11 +25,11 @@ pi -e ./agent-goal/index.ts
 /goal resume       Resume and immediately continue
 /goal complete     Mark complete manually
 /goal clear        Delete the goal
-/goal hide         Hide the persistent goal dashboard
-/goal show         Show the persistent goal dashboard
+/goal hide         Hide the compact persistent goal status
+/goal show         Show the compact persistent goal status
 ```
 
-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.
+Pi's footer is the only persistent goal UI and shows compact status and budget usage without duplicating the detailed dashboard. In interactive mode, `/goal` opens the detailed control window with the objective, lifecycle state, budget bars, latest evaluator guidance, and continuation state. Its visible keyboard actions pause or resume the goal, mark it complete, clear it, or close the window; complete and clear require a second keypress, and the window refreshes after state changes. Press Escape, `q`, or Ctrl+C to close it. `/goal` retains the detailed textual dashboard in headless sessions.
 
 Only one goal may exist per Pi session. Clear the existing goal before creating another.
 

package/dist/goal-window.d.ts

@@ -1,13 +1,16 @@
 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 type GoalWindowAction = "pause" | "resume" | "complete" | "clear" | "close";
 export declare class GoalWindow implements Component {
     private readonly goal;
     private readonly claim;
     private readonly theme;
-    private readonly onClose;
+    private readonly onAction;
+    private readonly requestRender;
     private readonly now;
-    constructor(goal: AgentGoal | undefined, claim: GoalContinuationClaim | undefined, theme: Theme, onClose: () => void, now?: () => number);
+    private pendingConfirmation;
+    constructor(goal: AgentGoal | undefined, claim: GoalContinuationClaim | undefined, theme: Theme, onAction: (action: GoalWindowAction) => void, requestRender?: () => void, now?: () => number);
     handleInput(data: string): void;
     render(width: number): string[];
     invalidate(): void;

package/dist/goal-window.js

@@ -17,21 +17,60 @@ export class GoalWindow {
     goal;
     claim;
     theme;
-    onClose;
+    onAction;
+    requestRender;
     now;
-    constructor(goal, claim, theme, onClose, now = Date.now) {
+    pendingConfirmation;
+    constructor(goal, claim, theme, onAction, requestRender = () => undefined, now = Date.now) {
         this.goal = goal;
         this.claim = claim;
         this.theme = theme;
-        this.onClose = onClose;
+        this.onAction = onAction;
+        this.requestRender = requestRender;
         this.now = now;
     }
     handleInput(data) {
-        if (matchesKey(data, "escape") ||
-            matchesKey(data, "ctrl+c") ||
-            matchesKey(data, "return") ||
-            data.toLowerCase() === "q") {
-            this.onClose();
+        const key = data.toLowerCase();
+        if (matchesKey(data, "ctrl+c") || key === "q") {
+            this.onAction("close");
+            return;
+        }
+        if (matchesKey(data, "escape")) {
+            if (this.pendingConfirmation) {
+                this.pendingConfirmation = undefined;
+                this.requestRender();
+            }
+            else {
+                this.onAction("close");
+            }
+            return;
+        }
+        if (!this.goal)
+            return;
+        if (this.pendingConfirmation) {
+            const confirmationKey = this.pendingConfirmation === "complete" ? "c" : "x";
+            if (key === confirmationKey) {
+                this.onAction(this.pendingConfirmation);
+            }
+            else {
+                this.pendingConfirmation = undefined;
+                this.requestRender();
+            }
+            return;
+        }
+        if (key === "p" && this.goal.status === "active") {
+            this.onAction("pause");
+        }
+        else if (key === "r" && (this.goal.status === "paused" || this.goal.status === "blocked")) {
+            this.onAction("resume");
+        }
+        else if (key === "c" && this.goal.status !== "complete") {
+            this.pendingConfirmation = "complete";
+            this.requestRender();
+        }
+        else if (key === "x") {
+            this.pendingConfirmation = "clear";
+            this.requestRender();
         }
     }
     render(width) {
@@ -53,7 +92,7 @@ export class GoalWindow {
         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(row(` ${this.theme.fg("dim", "esc · q  close")}`));
             lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
             return lines;
         }
@@ -93,7 +132,17 @@ export class GoalWindow {
         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")}`));
+        const actions = [
+            this.goal.status === "active" ? "p pause" : undefined,
+            this.goal.status === "paused" || this.goal.status === "blocked" ? "r resume" : undefined,
+            this.goal.status !== "complete" ? "c complete" : undefined,
+            "x clear",
+            "q close",
+        ].filter((action) => action !== undefined);
+        const footer = this.pendingConfirmation
+            ? `${this.pendingConfirmation === "complete" ? "c" : "x"} again to confirm ${this.pendingConfirmation} · esc cancel`
+            : actions.join(" · ");
+        lines.push(row(), row(` ${this.theme.fg("dim", footer)}`));
         lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
         return lines;
     }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ 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 { displayGoalText, formatGoalDashboard, formatGoalStatus } from "./dashboard.js";
-export { GoalWindow } from "./goal-window.js";
+export { GoalWindow, type GoalWindowAction } 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

@@ -73,13 +73,27 @@ export function registerAgentGoal(pi, options = {}) {
     const refreshUi = async (ctx) => {
         const scopeId = ctx.sessionManager.getSessionId();
         const goal = await runtime.get(scopeId);
-        ctx.ui.setStatus(STATUS_KEY, goal ? formatGoalStatus(goal) : undefined);
-        if (!goal || hiddenScopes.has(scopeId)) {
-            ctx.ui.setWidget(WIDGET_KEY, undefined);
-            return;
+        const hidden = hiddenScopes.has(scopeId);
+        ctx.ui.setStatus(STATUS_KEY, goal && !hidden ? formatGoalStatus(goal) : undefined);
+        ctx.ui.setWidget(WIDGET_KEY, undefined);
+    };
+    const applyGoalAction = async (scopeId, action) => {
+        switch (action) {
+            case "pause":
+                await runtime.setStatus(scopeId, "paused");
+                break;
+            case "resume":
+                await runtime.setStatus(scopeId, "active");
+                await runtime.start(scopeId, "Resume the goal from current state.");
+                break;
+            case "complete":
+                await runtime.setStatus(scopeId, "complete");
+                break;
+            case "clear":
+                if (!(await runtime.clear(scopeId)))
+                    throw new Error("This session has no goal");
+                break;
         }
-        const claim = await runtime.getContinuationClaim(scopeId);
-        ctx.ui.setWidget(WIDGET_KEY, formatGoalDashboard(goal, claim), { placement: "belowEditor" });
     };
     pi.on("session_start", async (_event, rawCtx) => {
         const ctx = rawCtx;
@@ -277,47 +291,46 @@ export function registerAgentGoal(pi, options = {}) {
             const input = args.trim();
             try {
                 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
-                            ? formatGoalDashboard(goal, claim).join("\n")
-                            : "This session has no goal.",
-                        display: true,
-                    }, { triggerTurn: false });
-                    return;
+                    while (true) {
+                        const goal = await runtime.get(scopeId);
+                        const claim = await runtime.getContinuationClaim(scopeId);
+                        const action = await ctx.ui.custom((tui, theme, _keybindings, done) => {
+                            openedWindow = true;
+                            return new GoalWindow(goal, claim, theme, done, () => tui.requestRender());
+                        }, {
+                            overlay: true,
+                            overlayOptions: {
+                                anchor: "center",
+                                width: 66,
+                                minWidth: 36,
+                                maxHeight: "80%",
+                                margin: 1,
+                            },
+                        });
+                        if (!openedWindow) {
+                            api.sendMessage({
+                                customType: "agent-goal.status",
+                                content: goal
+                                    ? formatGoalDashboard(goal, claim).join("\n")
+                                    : "This session has no goal.",
+                                display: true,
+                            }, { triggerTurn: false });
+                            return;
+                        }
+                        if (!action || action === "close")
+                            return;
+                        await applyGoalAction(scopeId, action);
+                        await refreshUi(ctx);
+                    }
                 }
-                switch (input.toLowerCase()) {
+                const command = input.toLowerCase();
+                switch (command) {
                     case "pause":
-                        await runtime.setStatus(scopeId, "paused");
-                        break;
                     case "resume":
-                        await runtime.setStatus(scopeId, "active");
-                        await runtime.start(scopeId, "Resume the goal from current state.");
-                        break;
                     case "complete":
-                        await runtime.setStatus(scopeId, "complete");
-                        break;
                     case "clear":
-                        if (!(await runtime.clear(scopeId)))
-                            throw new Error("This session has no goal");
+                        await applyGoalAction(scopeId, command);
                         break;
                     case "hide":
                         hiddenScopes.add(scopeId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinet/agent-goal",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "type": "module",
   "description": "Standalone single-agent durable goal loop for Pi",
   "author": "Will Porcellini <5994936+gugu91@users.noreply.github.com>",