@narumitw/pi-caffeinate 0.4.3 → 0.6.0

package/README.md

@@ -16,7 +16,7 @@ It is designed for long-running coding, refactoring, debugging, web research, an
 - Provides a single `/caffeinate` command with menu-based controls and direct subcommands.
 - Persists the selected keep-awake mode in a small JSON settings file.
 - Allows a custom inhibitor command through environment configuration.
-- Allows a custom status icon through environment configuration.
+- Emits plain status text; `@narumitw/pi-statusline` can add or suppress the status icon from JSON config.
 - Fails safely when no supported inhibitor is available.
 
 ## 📦 Install
@@ -128,17 +128,23 @@ PI_CAFFEINATE_COMMAND='systemd-inhibit --what=idle:sleep --why="pi running" --mo
 
 The custom command is parsed with shell-like quoting and is run directly without a shell. `PI_CAFFEINATE_COMMAND` takes precedence over the saved mode; `/caffeinate status` reports when a custom command is active.
 
-Customise the status bar icon (default: `💊`):
+Deprecated: `PI_CAFFEINATE_ICON` still works for now. If you use `@narumitw/pi-statusline`, move the icon to `${PI_CODING_AGENT_DIR:-~/.pi/agent}/pi-statusline-settings.json`:
 
-```bash
-PI_CAFFEINATE_ICON='☕️' pi
+```json
+{
+  "extensionStatusIcons": {
+    "caffeinate": "☕️"
+  }
+}
 ```
 
+Without `@narumitw/pi-statusline`, keep using `PI_CAFFEINATE_ICON` during the compatibility window. In `pi-statusline-settings.json`, use an empty string to show the caffeinate status without an icon.
+
 ## 🧠 Why use pi-caffeinate?
 
 AI coding agents often run tool-heavy tasks that take several minutes. `pi-caffeinate` keeps your machine awake during active Pi work, helping browser automation, local builds, test runs, code generation, and long prompts finish reliably.
 
-The default display-awake mode prioritizes uninterrupted long-running Pi work across platforms, including Linux desktops that require idle inhibition to prevent automatic suspend. Use sleep-only mode when you prefer normal screen power saving and your system does not need idle inhibition to keep Pi running.
+The default display-awake mode prioritizes uninterrupted long-running Pi work across platforms, including Linux desktops that require idle inhibition to prevent automatic suspend. Use `/caffeinate sleep` (shown as `system-awake` in status output) when you prefer normal screen power saving and your system does not need idle inhibition to keep Pi running.
 
 ## 🗂️ Package layout
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-caffeinate",
-	"version": "0.4.3",
+	"version": "0.6.0",
 	"description": "Pi extension that keeps the computer awake while the agent is running.",
 	"type": "module",
 	"license": "MIT",
@@ -30,7 +30,7 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.4.14",
-		"@earendil-works/pi-coding-agent": "0.74.0",
+		"@earendil-works/pi-coding-agent": "0.79.8",
 		"@types/node": "25.6.0",
 		"typescript": "6.0.3"
 	},

package/src/caffeinate.ts

@@ -61,6 +61,7 @@ interface CaffeinateState {
 	mode: CaffeinateMode;
 	settingsLoaded: boolean;
 	settingsError?: string;
+	iconWarningShown: boolean;
 }
 
 interface CaffeinateSettings {
@@ -74,10 +75,13 @@ const state: CaffeinateState = {
 	disabled: isDisabled(),
 	mode: DEFAULT_MODE,
 	settingsLoaded: false,
+	iconWarningShown: false,
 };
 
 export default function caffeinate(pi: ExtensionAPI) {
 	pi.on("session_start", async (_event, ctx) => {
+		state.iconWarningShown = false;
+		warnDeprecatedIcon(ctx);
 		await loadSettingsIntoState(ctx);
 		updateStatus(ctx);
 	});
@@ -315,7 +319,7 @@ function startInhibitor(ctx: ExtensionContext) {
 			updateStatus(ctx);
 		});
 
-		ctx.ui.notify(`Keeping computer awake with ${command.description}.`, "info");
+		ctx.ui.notify(`Keeping computer awake (${statusModeLabel()}).`, "info");
 		updateStatus(ctx);
 	} catch (error) {
 		state.process = undefined;
@@ -527,12 +531,12 @@ function updateStatus(ctx: ExtensionContext) {
 	}
 
 	if (state.process) {
-		ctx.ui.setStatus(STATUS_KEY, `${getIcon()} ${statusModeLabel()}`);
+		ctx.ui.setStatus(STATUS_KEY, withDeprecatedIcon(statusModeLabel()));
 		return;
 	}
 
 	if (!state.available) {
-		ctx.ui.setStatus(STATUS_KEY, `${getIcon()} unavailable`);
+		ctx.ui.setStatus(STATUS_KEY, withDeprecatedIcon("unavailable"));
 		return;
 	}
 
@@ -576,11 +580,11 @@ function statusLevel() {
 
 function statusModeLabel() {
 	if (state.command?.custom) return "custom";
-	return state.mode === "sleep" ? "sleep" : "display";
+	return formatMode(state.mode);
 }
 
 export function formatMode(mode: CaffeinateMode) {
-	return mode === "sleep" ? "sleep-only" : "display-awake";
+	return mode === "sleep" ? "system-awake" : "display-awake";
 }
 
 async function ensureSettingsLoaded(ctx: ExtensionContext) {
@@ -683,6 +687,16 @@ function hasCustomCommand() {
 	return Boolean(process.env.PI_CAFFEINATE_COMMAND?.trim());
 }
 
-function getIcon() {
-	return process.env.PI_CAFFEINATE_ICON?.trim() ?? "💊";
+function withDeprecatedIcon(text: string) {
+	const icon = process.env.PI_CAFFEINATE_ICON?.trim();
+	return icon ? `${icon} ${text}` : text;
+}
+
+function warnDeprecatedIcon(ctx: ExtensionContext) {
+	if (state.iconWarningShown || !process.env.PI_CAFFEINATE_ICON?.trim()) return;
+	state.iconWarningShown = true;
+	ctx.ui.notify(
+		"PI_CAFFEINATE_ICON is deprecated but still works for now. If you use @narumitw/pi-statusline, move it to pi-statusline-settings.json (extensionStatusIcons.caffeinate).",
+		"warning",
+	);
 }