toast-meter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sylvia Schmitt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# toast-meter
+
+Playful Pi package for a footer context-usage indicator.
+
+License: MIT  
+Author: Sylvia Schmitt
+
+## What it does
+
+- Shows current context usage in Pi's footer
+- Uses brains → bricks / bread as the context fills up
+- Switches the final stage label to `House is on fire`
+- Supports English and German presets
+- Lets projects override thresholds only
+
+## Install with Pi
+
+Local path:
+
+```json
+{
+  "packages": ["./path/to/toast-meter"]
+}
+```
+
+Git:
+
+```json
+{
+  "packages": ["git:github.com/ai2ys/toast-meter@v0.1.0"]
+}
+```
+
+npm:
+
+```json
+{
+  "packages": ["npm:toast-meter@0.1.0"]
+}
+```
+
+Or via commands:
+
+```bash
+pi install /absolute/path/to/toast-meter
+pi install git:github.com/ai2ys/toast-meter@v0.1.0
+pi install npm:toast-meter@0.1.0
+```
+
+## Example output
+
+### English
+
+```text
+0k   🧠🧠🧠🧠 • Dumb as a Brick
+120k 🧠🧱🧱🧱 • Dumb as a Brick
+151k 🏠🔥 • House is on fire
+```
+
+### Deutsch
+
+```text
+0k   🧠🧠🧠🧠 • Dumm wie Brot
+120k 🧠🍞🍞🍞 • Dumm wie Brot
+151k 🏠🔥 • House is on fire
+```
+
+## Configuration
+
+Package defaults live here:
+
+- `extensions/toast-meter/config.default.json`
+
+Project override (optional):
+
+- `.pi/toast-meter.json`
+
+Example override:
+
+```json
+{
+  "mode": "en",
+  "showText": true,
+  "refreshIntervalMs": 2000,
+  "levels": {
+    "1": 80000,
+    "2": 100000,
+    "3": 120000,
+    "4": 140000,
+    "5": 150000
+  }
+}
+```
+
+## Notes
+
+- Level 0 is fixed in code.
+- Icons are fixed in code.
+- Thresholds 1–5 are configurable.
+- Default mode is `en`.
+- The package is discoverable on Pi package listings via the `pi-package` keyword.

package/extensions/toast-meter/README.md

@@ -0,0 +1,24 @@
+# toast-meter extension
+
+This extension is part of the `toast-meter` Pi package.
+
+## Configuration
+
+Project overrides go in:
+
+- `.pi/toast-meter.json`
+
+Package defaults live in:
+
+- `config.default.json`
+
+Supported options include:
+
+- `mode`: `"en"` or `"de"`
+- `showText`: `true` or `false`
+- `refreshIntervalMs`: number
+- `levels`: thresholds for levels `1` to `5`
+
+See the main package README for installation, examples, and full configuration details:
+
+- [`../../README.md`](../../README.md)

package/extensions/toast-meter/config.default.json

@@ -0,0 +1,12 @@
+{
+  "mode": "en",
+  "showText": true,
+  "refreshIntervalMs": 2000,
+  "levels": {
+    "1": 80000,
+    "2": 100000,
+    "3": 120000,
+    "4": 140000,
+    "5": 150000
+  }
+}

package/extensions/toast-meter/index.ts

@@ -0,0 +1,126 @@
+import fs from "node:fs";
+import path from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+const WIDGET_KEY = "smart-dumb-zone-indicator";
+const DEFAULT_CONFIG_PATH = path.join(__dirname, "config.default.json");
+const PROJECT_CONFIG_PATH = path.join(process.cwd(), ".pi", "toast-meter.json");
+const DEFAULT_REFRESH_MS = 2000;
+
+type IndicatorConfig = {
+	mode?: "de" | "en";
+	refreshIntervalMs?: number;
+	showText?: boolean;
+	label?: string;
+	levels?: Partial<Record<1 | 2 | 3 | 4 | 5, number>>;
+};
+
+type Preset = {
+	label: string;
+	icons: [string, string, string, string, string, string];
+	thresholds: [number, number, number, number, number];
+};
+
+const PRESETS: Record<NonNullable<IndicatorConfig["mode"]>, Preset> = {
+	de: {
+		label: "Dumm wie Brot",
+		icons: ["🧠🧠🧠🧠", "🧠🧠🧠🍞", "🧠🧠🍞🍞", "🧠🍞🍞🍞", "🍞🍞🍞🍞", "🏠🔥"],
+		thresholds: [80e3, 100e3, 120e3, 140e3, 150e3],
+	},
+	en: {
+		label: "Dumb as a Brick",
+		icons: ["🧠🧠🧠🧠", "🧠🧠🧠🧱", "🧠🧠🧱🧱", "🧠🧱🧱🧱", "🧱🧱🧱🧱", "🏠🔥"],
+		thresholds: [80e3, 100e3, 120e3, 140e3, 150e3],
+	},
+};
+
+const DEFAULT_MODE: NonNullable<IndicatorConfig["mode"]> = "en";
+const FINAL_STAGE_LABEL = "House is on fire";
+
+function readJsonConfig(configPath: string): IndicatorConfig {
+	try {
+		const raw = fs.readFileSync(configPath, "utf8");
+		return JSON.parse(raw) as IndicatorConfig;
+	} catch {
+		return {};
+	}
+}
+
+function readConfig(): IndicatorConfig {
+	const defaults = readJsonConfig(DEFAULT_CONFIG_PATH);
+	const project = readJsonConfig(PROJECT_CONFIG_PATH);
+	return {
+		...defaults,
+		...project,
+		levels: {
+			...(defaults.levels ?? {}),
+			...(project.levels ?? {}),
+		},
+	};
+}
+
+function buildLevels(config: IndicatorConfig): { at: number; icon: string }[] {
+	const mode = config.mode ?? DEFAULT_MODE;
+	const preset = PRESETS[mode];
+	const thresholds = preset.thresholds.map((fallback, index) => config.levels?.[(index + 1) as 1 | 2 | 3 | 4 | 5] ?? fallback);
+	return [
+		{ at: 0, icon: preset.icons[0] },
+		...thresholds.map((at, index) => ({ at, icon: preset.icons[index + 1] })),
+	];
+}
+
+function formatStatus(ctx: ExtensionContext, config: IndicatorConfig): string {
+	const usage = ctx.getContextUsage();
+	const tokens = usage?.tokens ?? null;
+	const theme = ctx.ui.theme;
+	const mode = config.mode ?? DEFAULT_MODE;
+	const preset = PRESETS[mode];
+	const label = config.label ?? preset.label;
+	const levels = buildLevels(config);
+
+	if (tokens === null) {
+		return theme.fg("muted", `${label}: ?`);
+	}
+
+	const k = Math.round(tokens / 1000);
+	const showText = config.showText ?? false;
+	const current = levels.reduce((acc, level) => (tokens >= level.at ? level.icon : acc), levels[0]?.icon ?? "🍞");
+	const isFinalStage = tokens >= (levels[levels.length - 1]?.at ?? Number.MAX_SAFE_INTEGER);
+	const value = theme.fg("muted", `${k}k`);
+	const iconPart = theme.fg(isFinalStage ? "error" : tokens >= 100e3 ? "warning" : "success", current);
+	if (!showText) return `${value} ${iconPart}`;
+	const textLabel = isFinalStage ? FINAL_STAGE_LABEL : label;
+	return `${value} ${iconPart} ${theme.fg("dim", "•")} ${theme.fg("muted", textLabel)}`;
+}
+
+export default function (pi: ExtensionAPI) {
+	let timer: ReturnType<typeof setInterval> | null = null;
+
+	const stopTimer = () => {
+		if (timer) {
+			clearInterval(timer);
+			timer = null;
+		}
+	};
+
+	const refresh = (ctx: ExtensionContext) => {
+		if (!ctx.hasUI) return;
+		const config = readConfig();
+		ctx.ui.setStatus(WIDGET_KEY, formatStatus(ctx, config));
+	};
+
+	pi.on("session_start", (_event, ctx) => {
+		refresh(ctx);
+		stopTimer();
+		const config = readConfig();
+		const refreshMs = config.refreshIntervalMs ?? DEFAULT_REFRESH_MS;
+		timer = setInterval(() => refresh(ctx), refreshMs);
+	});
+
+	pi.on("turn_end", (_event, ctx) => refresh(ctx));
+	pi.on("model_select", (_event, ctx) => refresh(ctx));
+	pi.on("session_shutdown", (_event, ctx) => {
+		stopTimer();
+		if (ctx.hasUI) ctx.ui.setStatus(WIDGET_KEY, undefined);
+	});
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "toast-meter",
+  "version": "0.1.0",
+  "description": "Playful Pi footer indicator for context usage",
+  "license": "MIT",
+  "author": "Sylvia Schmitt",
+  "keywords": ["pi-package"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ai2ys/toast-meter.git"
+  },
+  "homepage": "https://github.com/ai2ys/toast-meter#readme",
+  "bugs": {
+    "url": "https://github.com/ai2ys/toast-meter/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": ["extensions", "assets", "README.md", "package.json"],
+  "pi": {
+    "extensions": ["./extensions"],
+    "image": "https://raw.githubusercontent.com/ai2ys/toast-meter/main/assets/preview.png"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}