@narumitw/pi-caffeinate 0.14.0 → 0.15.0

package/README.md

@@ -14,7 +14,7 @@ It is designed for long-running coding, refactoring, debugging, web research, an
 - Supports macOS, Windows, WSL, and Linux.
 - Defaults to display-awake mode on every supported OS: prevent system sleep and keep the screen/display awake.
 - Provides a single `/caffeinate` command with menu-based controls and direct subcommands.
-- Persists the selected keep-awake mode in a small JSON settings file.
+- Persists the selected keep-awake mode and optional quiet mode in a small JSON settings file.
 - Allows a custom inhibitor command 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.
@@ -77,7 +77,7 @@ Keeps the system awake while allowing normal display sleep. If an inhibitor is c
 /caffeinate status
 ```
 
-Shows whether an inhibitor is active, unavailable, disabled, or idle. The status includes the current mode and settings file path.
+Shows whether an inhibitor is active, unavailable, disabled, or idle. The status includes the current mode, quiet mode, and settings file path.
 
 ```text
 /caffeinate mode
@@ -93,7 +93,7 @@ Releases any active inhibitor until Pi starts another agent run.
 
 ## ⚙️ Configuration
 
-### Persisted mode
+### Persisted settings
 
 `/caffeinate sleep` and `/caffeinate display` save the selected mode to:
 
@@ -106,11 +106,19 @@ Example:
 ```json
 {
   "mode": "display",
+  "quiet": true,
   "updatedAt": 1791763200000
 }
 ```
 
-Missing, invalid, or deleted settings default back to `display` mode on every supported OS.
+Set `"quiet": true` to hide the routine `Keeping computer awake (...)` and
+`Released pi-caffeinate (agent finished)` lifecycle notifications. Quiet mode does not hide
+warnings, status updates, or feedback from `/caffeinate` commands such as `status`, mode changes,
+help, and manual stop. It defaults to `false` when omitted. The file is read at startup and on
+`/reload`; run `/reload` after editing it in a running Pi session before using mode commands.
+
+Missing, invalid, or deleted settings default back to `display` mode with quiet mode disabled on
+every supported OS.
 
 Compatibility: older versions used `pi-caffeinate-settings.json`. During the migration window, a
 legacy-only file is automatically migrated to `pi-caffeinate.json` with a warning. If both files
@@ -133,7 +141,7 @@ 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.
 
-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`:
+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.json`:
 
 ```json
 {
@@ -143,7 +151,7 @@ Deprecated: `PI_CAFFEINATE_ICON` still works for now. If you use `@narumitw/pi-s
 }
 ```
 
-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.
+Without `@narumitw/pi-statusline`, keep using `PI_CAFFEINATE_ICON` during the compatibility window. In `pi-statusline.json`, use an empty string to show the caffeinate status without an icon.
 
 ## 🧠 Why use pi-caffeinate?
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-caffeinate",
-	"version": "0.14.0",
+	"version": "0.15.0",
 	"description": "Pi extension that keeps the computer awake while the agent is running.",
 	"type": "module",
 	"license": "MIT",

package/src/caffeinate.ts

@@ -56,6 +56,7 @@ interface CaffeinateState {
 	available: boolean;
 	disabled: boolean;
 	mode: CaffeinateMode;
+	quiet: boolean;
 	settingsLoaded: boolean;
 	settingsError?: string;
 	settingsNotice?: string;
@@ -67,6 +68,7 @@ const state: CaffeinateState = {
 	available: true,
 	disabled: isDisabled(),
 	mode: DEFAULT_MODE,
+	quiet: false,
 	settingsLoaded: false,
 	iconWarningShown: false,
 };
@@ -83,12 +85,14 @@ export default function caffeinate(pi: ExtensionAPI) {
 	pi.on("agent_start", async (_event, ctx) => {
 		await ensureSettingsLoaded(ctx);
 		state.activeTurns += 1;
-		startInhibitor(ctx);
+		startInhibitor(ctx, { notify: !state.quiet });
 	});
 
 	pi.on("agent_end", (_event, ctx) => {
 		state.activeTurns = Math.max(0, state.activeTurns - 1);
-		if (state.activeTurns === 0) stopInhibitor(ctx, "agent finished");
+		if (state.activeTurns === 0) {
+			stopInhibitor(ctx, "agent finished", { notify: !state.quiet });
+		}
 		updateStatus(ctx);
 	});
 
@@ -195,7 +199,7 @@ async function setMode(ctx: ExtensionContext, mode: CaffeinateMode) {
 
 	let saved = true;
 	try {
-		await saveSettings({ mode, updatedAt: Date.now() });
+		await saveSettings({ mode, quiet: state.quiet, updatedAt: Date.now() });
 	} catch (error) {
 		saved = false;
 		state.settingsError = `settings save failed: ${formatError(error)}`;
@@ -204,7 +208,7 @@ async function setMode(ctx: ExtensionContext, mode: CaffeinateMode) {
 
 	if (state.process && previousMode !== mode && !state.command?.custom) {
 		stopInhibitor(ctx, "mode changed", { notify: false });
-		startInhibitor(ctx);
+		startInhibitor(ctx, { notify: !state.quiet });
 	}
 
 	ctx.ui.notify(
@@ -261,7 +265,7 @@ function buildCommandGuide() {
 	].join("\n");
 }
 
-function startInhibitor(ctx: ExtensionContext) {
+function startInhibitor(ctx: ExtensionContext, options: { notify?: boolean } = {}) {
 	if (state.disabled || state.process) {
 		updateStatus(ctx);
 		return;
@@ -293,6 +297,7 @@ function startInhibitor(ctx: ExtensionContext) {
 				if (state.process !== child) return;
 				state.process = undefined;
 				state.startedAt = undefined;
+				state.available = false;
 				state.lastError = `${command.description} exited unexpectedly (${exit}).`;
 				ctx.ui.notify(state.lastError, "warning");
 				updateStatus(ctx);
@@ -303,7 +308,9 @@ function startInhibitor(ctx: ExtensionContext) {
 		state.command = command;
 		state.available = true;
 		state.lastError = undefined;
-		ctx.ui.notify(`Keeping computer awake (${statusModeLabel()}).`, "info");
+		if (options.notify !== false) {
+			ctx.ui.notify(`Keeping computer awake (${statusModeLabel()}).`, "info");
+		}
 		updateStatus(ctx);
 	} catch (error) {
 		state.process = undefined;
@@ -348,6 +355,7 @@ function describeState() {
 	const customCommand = hasCustomCommand();
 	const lines = [
 		`Mode: ${formatMode(state.mode)}${customCommand ? " (overridden by custom command)" : ""}`,
+		`Quiet mode: ${state.quiet ? "enabled" : "disabled"}`,
 		`Settings: ${settingsFilePath()}`,
 	];
 
@@ -394,6 +402,7 @@ async function loadSettingsIntoState(ctx: ExtensionContext) {
 	if (state.disabled) {
 		state.settingsLoaded = true;
 		state.settingsError = undefined;
+		state.quiet = false;
 		return;
 	}
 
@@ -407,10 +416,12 @@ async function loadSettingsIntoState(ctx: ExtensionContext) {
 
 	if (settings.kind === "loaded") {
 		state.mode = settings.settings.mode;
+		state.quiet = settings.settings.quiet;
 		return;
 	}
 
 	state.mode = DEFAULT_MODE;
+	state.quiet = false;
 	if (settings.kind === "invalid") {
 		state.settingsError = settings.reason;
 		ctx.ui.notify(
@@ -442,7 +453,7 @@ 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).",
+		"PI_CAFFEINATE_ICON is deprecated but still works for now. If you use @narumitw/pi-statusline, move it to pi-statusline.json (extensionStatusIcons.caffeinate).",
 		"warning",
 	);
 }

package/src/settings.ts

@@ -11,6 +11,7 @@ export type CaffeinateMode = "sleep" | "display";
 
 export interface CaffeinateSettings {
 	mode: CaffeinateMode;
+	quiet: boolean;
 	updatedAt: number;
 }
 
@@ -59,7 +60,10 @@ async function readSettingsFile(filePath: string): Promise<SettingsLoadResult> {
 	try {
 		const settings = normalizeCaffeinateSettings(JSON.parse(text) as unknown);
 		if (settings) return { kind: "loaded", settings };
-		return { kind: "invalid", reason: `${filePath}: expected { "mode": "sleep" | "display" }` };
+		return {
+			kind: "invalid",
+			reason: `${filePath}: expected { "mode": "sleep" | "display", optional "quiet": boolean }`,
+		};
 	} catch (error) {
 		return { kind: "invalid", reason: `${filePath}: ${formatError(error)}` };
 	}
@@ -108,10 +112,11 @@ async function fileExists(filePath: string) {
 
 export function normalizeCaffeinateSettings(value: unknown): CaffeinateSettings | undefined {
 	if (!value || typeof value !== "object") return undefined;
-	const settings = value as { mode?: unknown; updatedAt?: unknown };
+	const settings = value as { mode?: unknown; quiet?: unknown; updatedAt?: unknown };
 	if (!isCaffeinateMode(settings.mode)) return undefined;
+	if (settings.quiet !== undefined && typeof settings.quiet !== "boolean") return undefined;
 	if (settings.updatedAt !== undefined && typeof settings.updatedAt !== "number") return undefined;
-	return { mode: settings.mode, updatedAt: settings.updatedAt ?? 0 };
+	return { mode: settings.mode, quiet: settings.quiet ?? false, updatedAt: settings.updatedAt ?? 0 };
 }
 
 function isCaffeinateMode(value: unknown): value is CaffeinateMode {