pi-goal 0.1.1 → 0.1.3

package/.pi/extensions/pi-goal/index.ts

@@ -21,6 +21,7 @@ type GoalState = {
 type GoalEventKind = "active" | "continuation" | "paused" | "resumed" | "cleared" | "budget_limited" | "complete";
 
 let goal: GoalState | null = null;
+let statusBarEnabled = true;
 let activeTurnStartedAt: number | null = null;
 let continuationQueued = false;
 let pendingControlPrompt: string | null = null;
@@ -118,22 +119,46 @@ function emitGoalEvent(
 	);
 }
 
-function latestGoalFromSession(ctx: ExtensionContext): GoalState | null {
+function latestStateFromSession(ctx: ExtensionContext): { goal: GoalState | null; statusBarEnabled: boolean } {
 	const entries = ctx.sessionManager.getBranch?.() ?? ctx.sessionManager.getEntries();
 	for (let i = entries.length - 1; i >= 0; i--) {
 		const entry = entries[i] as any;
 		if (entry.type === "custom" && entry.customType === CUSTOM_TYPE) {
-			return entry.data?.goal ?? null;
+			return {
+				goal: entry.data?.goal ?? null,
+				statusBarEnabled: entry.data?.statusBarEnabled ?? true,
+			};
 		}
 	}
-	return null;
+	return { goal: null, statusBarEnabled: true };
+}
+
+function updateStatusBar(ctx: ExtensionContext) {
+	ctx.ui.setStatus(CUSTOM_TYPE, statusBarEnabled ? statusLine(goal) ?? "" : "");
+}
+
+const GOAL_TOOL_NAMES = ["get_goal", "update_goal"];
+
+// Expose goal tools to the LLM only while a goal is actively being pursued.
+// When no goal exists (or it is paused / complete / budget-limited), keep them
+// hidden so unrelated sessions are not tempted to call them every turn.
+function syncGoalTools(pi: ExtensionAPI) {
+	const want = goal?.status === "active";
+	const active = new Set(pi.getActiveTools());
+	for (const name of GOAL_TOOL_NAMES) (want ? active.add(name) : active.delete(name));
+	pi.setActiveTools(Array.from(active));
 }
 
 function persist(pi: ExtensionAPI, ctx: ExtensionContext, next: GoalState | null) {
 	goal = next;
-	pi.appendEntry(CUSTOM_TYPE, { goal: next });
-	const line = statusLine(next);
-	ctx.ui.setStatus(CUSTOM_TYPE, line ?? "");
+	pi.appendEntry(CUSTOM_TYPE, { goal: next, statusBarEnabled });
+	updateStatusBar(ctx);
+	syncGoalTools(pi);
+}
+
+function persistSettings(pi: ExtensionAPI, ctx: ExtensionContext) {
+	pi.appendEntry(CUSTOM_TYPE, { goal, statusBarEnabled });
+	updateStatusBar(ctx);
 }
 
 function continuationPrompt(state: GoalState): string {
@@ -235,7 +260,10 @@ export default function piGoal(pi: ExtensionAPI) {
 		name: "get_goal",
 		label: "Get Goal",
 		description: "Read the current active thread goal, if one exists.",
-		promptSnippet: "Read the current thread goal and budget state",
+		promptSnippet: "Read the current pi-goal objective and remaining budget while pursuing it",
+		promptGuidelines: [
+			"Only call get_goal when you actually need the current objective or remaining budget; the continuation prompt already injects them.",
+		],
 		parameters: {
 			type: "object",
 			properties: {},
@@ -286,9 +314,9 @@ export default function piGoal(pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("goal", {
-		description: "Set, view, pause, resume, or clear a long-running goal",
+		description: "Set, view, pause, resume, clear, or configure a long-running goal",
 		getArgumentCompletions: (prefix) => {
-			const values = ["pause", "resume", "clear", "status"];
+			const values = ["pause", "resume", "clear", "status", "statusbar", "statusbar on", "statusbar off"];
 			const filtered = values.filter((value) => value.startsWith(prefix));
 			return filtered.length ? filtered.map((value) => ({ value, label: value })) : null;
 		},
@@ -298,7 +326,15 @@ export default function piGoal(pi: ExtensionAPI) {
 
 			if (!trimmed || trimmed === "status") {
 				if (!goal) ctx.ui.notify("Usage: /goal [--tokens 50k] <objective>", "info");
-				else ctx.ui.notify(`${statusLine(goal)}\nObjective: ${goal.objective}`, "info");
+				else ctx.ui.notify(`${statusLine(goal)}\nObjective: ${goal.objective}\nStatus bar: ${statusBarEnabled ? "on" : "off"}`, "info");
+				return;
+			}
+
+			if (trimmed === "statusbar" || trimmed === "statusbar toggle" || trimmed === "statusbar on" || trimmed === "statusbar off") {
+				const [, value] = trimmed.split(/\s+/, 2);
+				statusBarEnabled = value === "on" ? true : value === "off" ? false : !statusBarEnabled;
+				persistSettings(pi, ctx);
+				ctx.ui.notify(`Goal status bar ${statusBarEnabled ? "enabled" : "disabled"}.`, "info");
 				return;
 			}
 
@@ -357,10 +393,14 @@ export default function piGoal(pi: ExtensionAPI) {
 	});
 
 	pi.on("session_start", (event, ctx) => {
-		goal = latestGoalFromSession(ctx);
+		const restored = latestStateFromSession(ctx);
+		goal = restored.goal;
+		statusBarEnabled = restored.statusBarEnabled;
 		pendingControlPrompt = null;
 		continuationQueued = false;
 		activeTurnStartedAt = null;
+		// Hide goal tools from the LLM unless we have an active goal to pursue.
+		syncGoalTools(pi);
 		if (goal?.status === "active" && event.reason === "reload") {
 			goal = { ...goal, status: "paused", updatedAt: Date.now() };
 			persist(pi, ctx, goal);
@@ -372,7 +412,7 @@ export default function piGoal(pi: ExtensionAPI) {
 			);
 			return;
 		}
-		ctx.ui.setStatus(CUSTOM_TYPE, statusLine(goal) ?? "");
+		updateStatusBar(ctx);
 		if (goal?.status === "active") {
 			emitGoalEvent(
 				pi,

package/README.md

@@ -1,5 +1,7 @@
 # pi-goal
 
+![pi-goal](docs/assets/pi-goal-poster.png)
+
 Persistent autonomous goals for [pi](https://github.com/badlogic/pi-mono).
 
 `pi-goal` adds a `/goal` command and goal tools so Pi can keep working toward a long-running objective until the goal is complete, paused, cleared, or token-budget-limited.
@@ -25,6 +27,7 @@ pi install git:github.com/Michaelliv/pi-goal
 /goal pause
 /goal resume
 /goal clear
+/goal statusbar off
 ```
 
 When a goal is active, the extension shows compact visible lifecycle markers like `Goal active` and `Goal continuing`; expand them with `ctrl+o` to inspect the objective and usage. The actual continuation instructions are injected into the next turn's system prompt, so the full prompt does not clutter the transcript.
@@ -38,6 +41,7 @@ The same Pi agent keeps running normal turns in the same session context until i
 - `/goal pause`: stop autonomous continuation without deleting the goal
 - `/goal resume`: reactivate a paused goal
 - `/goal clear`: remove the goal
+- `/goal statusbar on|off`: show or hide the footer status line
 - `get_goal` tool: read current goal state
 - `update_goal` tool: model can only mark the goal `complete`
 - footer status: `Pursuing goal`, `Goal paused`, `Goal achieved`, or `Goal unmet`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Persistent autonomous goals for pi — /goal loops until complete, paused, or budget-limited",
   "type": "commonjs",
   "keywords": [