pi-curiosity 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# pi-curiosity
+
+A small Pi extension that periodically nudges coding agents to investigate evidence, reuse existing code, and keep new code easy for humans to find and understand.
+
+## Install
+
+```sh
+pi install npm:pi-curiosity
+```
+
+To try it without installing:
+
+```sh
+pi -e npm:pi-curiosity
+```
+
+## Configure
+
+The default is one cue every 10 tool calls. Configure the interval globally in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "pi-curiosity": {
+    "toolInterval": 10
+  }
+}
+```
+
+A project `.pi/settings.json` value overrides the global value. `toolInterval` must be a positive integer; invalid values use the default.
+
+The cue is injected into the next model context after the configured number of tool calls and is hidden from the visible transcript.

package/extensions/curiosity-steering.ts

@@ -0,0 +1,73 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import {
+	getAgentDir,
+	type ExtensionAPI,
+} from "@earendil-works/pi-coding-agent";
+
+const CURIOSITY_CUE =
+	"I'm curious—like a baby discovering the world: investigate the latest result, verify the next detail, reuse existing code, and keep new code easy for humans to find and understand as the project grows.";
+const DEFAULT_TOOL_INTERVAL = 10;
+const SETTINGS_KEY = "pi-curiosity";
+
+function readToolInterval(cwd: string): number {
+	let interval = DEFAULT_TOOL_INTERVAL;
+	for (const path of [
+		join(getAgentDir(), "settings.json"),
+		join(cwd, ".pi", "settings.json"),
+	]) {
+		if (!existsSync(path)) continue;
+		try {
+			const settings = JSON.parse(readFileSync(path, "utf8")) as Record<
+				string,
+				unknown
+			>;
+			const configured = (
+				settings[SETTINGS_KEY] as Record<string, unknown> | undefined
+			)?.toolInterval;
+			if (Number.isInteger(configured) && configured > 0) interval = configured;
+		} catch {
+			// Ignore malformed or unreadable settings and keep the last valid value.
+		}
+	}
+	return interval;
+}
+
+export default function (pi: ExtensionAPI) {
+	let toolUsesSinceCue = 0;
+	let injectOnNextContext = false;
+	let toolInterval = DEFAULT_TOOL_INTERVAL;
+
+	pi.on("session_start", (_event, ctx) => {
+		toolInterval = readToolInterval(ctx.cwd);
+	});
+
+	pi.on("turn_end", (event) => {
+		toolUsesSinceCue += event.toolResults.length;
+		injectOnNextContext = toolUsesSinceCue >= toolInterval;
+	});
+
+	pi.on("context", (event) => {
+		if (!injectOnNextContext) return;
+		injectOnNextContext = false;
+		toolUsesSinceCue = 0;
+
+		return {
+			messages: [
+				...event.messages,
+				{
+					role: "custom",
+					customType: "curiosity-steering",
+					content: CURIOSITY_CUE,
+					display: false,
+					timestamp: Date.now(),
+				},
+			],
+		};
+	});
+
+	pi.on("agent_end", () => {
+		injectOnNextContext = false;
+		toolUsesSinceCue = 0;
+	});
+}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "pi-curiosity",
+  "version": "0.1.0",
+  "description": "Periodic curiosity and code-navigation steering for Pi",
+  "keywords": ["pi-package", "pi", "extension", "curiosity"],
+  "license": "MIT",
+  "files": ["extensions/curiosity-steering.ts", "README.md", "package.json"],
+  "pi": {
+    "extensions": ["./extensions/curiosity-steering.ts"]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}