@xynogen/pix-commands 0.3.6 → 0.3.8

package/README.md

@@ -4,6 +4,7 @@ Pi extension providing focused slash commands:
 
 - `/clear` — flush Pi's cached model data.
 - `/btw <question>` — ask an isolated side question without interrupting the main agent.
+- `/afk` — toggle AFK mode for unattended runs.
 
 ## `/clear`
 
@@ -28,6 +29,30 @@ The child session:
 
 When the main agent is streaming, completion is shown as a notification and the durable card is appended after the main session becomes idle. This prevents the side answer from becoming steering input.
 
+## `/afk`
+
+`/afk` toggles AFK mode (away-from-keyboard) for unattended runs. It is a shared
+toggle stored in a global flag and shown in the status bar.
+
+When ON, yellow (medium-risk) permission gates auto-allow, while red (dangerous)
+gates and sudo prompts auto-deny:
+
+```text
+AFK mode on — yellow gates auto-allow; red and sudo auto-deny.
+```
+
+When OFF (the default), normal approval prompts are restored:
+
+```text
+AFK mode off — approval prompts restored.
+```
+
+The point is to let the agent keep working on safe, medium-risk actions while you
+are away, without silently permitting destructive ones. It pairs with the herdr
+notification bridge in `pix-runtime`: you still get pinged when something truly
+needs you (a red gate or sudo), and auto-deny turns that into a stop rather than
+an approval.
+
 ## Install
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-commands",
-	"version": "0.3.6",
+	"version": "0.3.8",
 	"description": "Pi extension — slash commands for cache clearing and isolated side questions",
 	"type": "module",
 	"main": "src/index.ts",
@@ -46,6 +46,6 @@
 	},
 	"dependencies": {
 		"@xynogen/pix-pretty": "^1.13.0",
-		"@xynogen/pix-runtime": "^0.5.3"
+		"@xynogen/pix-runtime": "^0.6.0"
 	}
 }

package/src/afk.ts

@@ -0,0 +1,35 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { icon } from "@xynogen/pix-pretty/icon-catalog";
+
+const STATUS_KEY = "afk";
+
+type AfkGlobal = typeof globalThis & { __pixAfk?: boolean };
+type StatusUI = {
+	theme: { fg(color: "error", text: string): string };
+	setStatus(key: string, text: string | undefined): void;
+};
+
+function setAfkStatus(ui: StatusUI, active: boolean): void {
+	ui.setStatus(STATUS_KEY, active ? ui.theme.fg("error", `${icon("afk")} AFK`) : undefined);
+}
+
+export default function registerAfk(pi: ExtensionAPI): void {
+	pi.on("session_start", (_event, ctx) => {
+		setAfkStatus(ctx.ui, (globalThis as AfkGlobal).__pixAfk === true);
+	});
+
+	pi.registerCommand("afk", {
+		description: "Toggle unattended gate behavior",
+		handler: async (_args, ctx) => {
+			const state = !(globalThis as AfkGlobal).__pixAfk;
+			(globalThis as AfkGlobal).__pixAfk = state;
+			setAfkStatus(ctx.ui, state);
+			ctx.ui.notify(
+				state
+					? "AFK mode on — yellow gates auto-allow; red and sudo auto-deny."
+					: "AFK mode off — approval prompts restored.",
+				state ? "warning" : "info",
+			);
+		},
+	});
+}

package/src/btw/render.ts

@@ -1,6 +1,7 @@
 import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
 import { Box, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
 import { icon } from "@xynogen/pix-pretty/icon-catalog";
+import { dotJoin } from "@xynogen/pix-pretty/utils";
 import { formatDuration as fmtDuration } from "@xynogen/pix-pretty/widget-format";
 
 export interface BtwMessageDetails {
@@ -33,8 +34,12 @@ export function registerBtwRenderer(
 		const statusGlyph = failed
 			? theme.fg("error", icon("status.error"))
 			: theme.fg("success", icon("status.ok"));
-		const meta = [details.model, details.thinkingLevel, formatDuration(details.durationMs)];
-		if (details.toolUses > 0) meta.push(`${details.toolUses} tools`);
+		const meta = dotJoin([
+			details.model,
+			details.thinkingLevel,
+			formatDuration(details.durationMs),
+			details.toolUses > 0 && `${details.toolUses} tools`,
+		]);
 
 		// A custom renderer bypasses Pi's default custom-message box, so provide
 		// our own card. Use selectedBg rather than the generic custom-message
@@ -44,11 +49,7 @@ export function registerBtwRenderer(
 		// header text embedded inside Markdown can confuse wrapping and parsing.
 		const card = new Box(1, 1, (text) => theme.bg("selectedBg", text));
 		card.addChild(
-			new Text(
-				`${statusGlyph} ${theme.bold("BTW")} ${theme.fg("dim", `· ${meta.join(" · ")}`)}`,
-				0,
-				0,
-			),
+			new Text(`${statusGlyph} ${theme.bold("BTW")} ${theme.fg("dim", `· ${meta}`)}`, 0, 0),
 		);
 		card.addChild(
 			new Text(`${theme.fg("accent", "▐")} ${theme.fg("muted", details.question)}`, 0, 0),

package/src/btw/widget.ts

@@ -9,6 +9,7 @@
 
 import { truncateToWidth } from "@earendil-works/pi-tui";
 import { icon } from "@xynogen/pix-pretty/icon-catalog";
+import { dotJoin } from "@xynogen/pix-pretty/utils";
 import {
 	type ContextUsageLike,
 	describeActivity,
@@ -73,7 +74,7 @@ function statsFor(job: BtwWidgetJob, endMs: number): string {
 	const speed = formatSpeed(job.outputTokens, endMs - job.startedAt);
 	if (speed) parts.push(speed);
 	parts.push(formatMs(endMs - job.startedAt));
-	return parts.join(" \u00b7 ");
+	return dotJoin(parts);
 }
 
 function finishedLine(job: BtwWidgetJob, theme: WidgetTheme): string {

package/src/extension.test.ts

@@ -1,32 +1,39 @@
 import { afterEach, describe, expect, test } from "bun:test";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { icon } from "@xynogen/pix-pretty/icon-catalog";
 import extension from "./extension.ts";
 
 afterEach(() => {
 	delete (globalThis as { __pixOnce?: WeakMap<object, Set<string>> }).__pixOnce;
+	delete (globalThis as { __pixAfk?: boolean }).__pixAfk;
 });
 
 describe("pix-commands registration", () => {
 	function host() {
 		const commands: string[] = [];
+		const handlers = new Map<string, (args: string, ctx: never) => Promise<void>>();
 		const renderers: string[] = [];
 		const pi = {
-			registerCommand(name: string) {
+			registerCommand(
+				name: string,
+				options: { handler?: (args: string, ctx: never) => Promise<void> },
+			) {
 				commands.push(name);
+				if (options.handler) handlers.set(name, options.handler);
 			},
 			registerEntryRenderer(name: string) {
 				renderers.push(name);
 			},
 			on() {},
 		} as unknown as ExtensionAPI;
-		return { pi, commands, renderers };
+		return { pi, commands, handlers, renderers };
 	}
 
-	test("registers /clear, /btw, and the BTW renderer once per Pi instance", () => {
+	test("registers /clear, /btw, /afk, and the BTW renderer once per Pi instance", () => {
 		const { pi, commands, renderers } = host();
 		extension(pi);
 		extension(pi);
-		expect(commands).toEqual(["clear", "btw"]);
+		expect(commands).toEqual(["clear", "btw", "afk"]);
 		expect(renderers).toEqual(["pix-btw-answer"]);
 	});
 
@@ -35,7 +42,32 @@ describe("pix-commands registration", () => {
 		const second = host();
 		extension(first.pi);
 		extension(second.pi);
-		expect(first.commands).toEqual(["clear", "btw"]);
-		expect(second.commands).toEqual(["clear", "btw"]);
+		expect(first.commands).toEqual(["clear", "btw", "afk"]);
+		expect(second.commands).toEqual(["clear", "btw", "afk"]);
+	});
+
+	test("/afk toggles shared state and status", async () => {
+		const { pi, handlers } = host();
+		extension(pi);
+		const statuses: Array<string | undefined> = [];
+		const notices: string[] = [];
+		const ctx = {
+			ui: {
+				theme: { fg: (color: string, text: string) => `<${color}>${text}</${color}>` },
+				setStatus: (_key: string, text: string | undefined) => statuses.push(text),
+				notify: (text: string) => notices.push(text),
+			},
+		};
+		const handler = handlers.get("afk");
+		if (!handler) throw new Error("/afk not registered");
+
+		await handler("", ctx as never);
+		expect((globalThis as { __pixAfk?: boolean }).__pixAfk).toBe(true);
+		expect(statuses.at(-1)).toBe(`<error>${icon("afk")} AFK</error>`);
+		expect(notices.at(-1)).toContain("yellow gates auto-allow");
+
+		await handler("", ctx as never);
+		expect((globalThis as { __pixAfk?: boolean }).__pixAfk).toBe(false);
+		expect(statuses.at(-1)).toBeUndefined();
 	});
 });

package/src/extension.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { once } from "@xynogen/pix-runtime/once";
+import registerAfk from "./afk.ts";
 import { registerBtw } from "./btw/index.ts";
 import registerClear from "./clear.ts";
 
@@ -7,5 +8,6 @@ export default function (pi: ExtensionAPI): void {
 	once(pi, "pix-commands", () => {
 		registerClear(pi);
 		registerBtw(pi);
+		registerAfk(pi);
 	});
 }