@henryqw/pi-auto-compact 1.1.9 → 2.0.0

package/README.md

@@ -1,11 +1,11 @@
 # `@henryqw/pi-auto-compact`
 
-Compact context before it hits the configured threshold, then resume the current task.
+Compact context before it reaches the configured threshold. Then resume the current task.
 
 ## Why
 
-- **Created for**: Compacting session context automatically before it reaches the configured threshold.
-- **Advantage**: Triggers early, uses a dedicated model, and resumes the interrupted task without manual intervention.
+- **Created for**: Compact session context automatically before it reaches the configured threshold.
+- **Advantage**: Trigger early, use a dedicated model, and resume the interrupted task without manual work.
 
 ## Install
 
@@ -14,14 +14,6 @@ pi install npm:@henryqw/pi-task-models
 pi install npm:@henryqw/pi-auto-compact
 ```
 
-Requires Pi Coding Agent 0.84.4+.
-
-## With
-
-| Package | Why |
-| --- | --- |
-| `@henryqw/pi-task-models` | Required. Shared model profiles for compaction routes. |
-
 Disable Pi's built-in auto-compaction in `~/.pi/agent/settings.json`:
 
 ```json
@@ -34,17 +26,27 @@ Disable Pi's built-in auto-compaction in `~/.pi/agent/settings.json`:
 
 Restart Pi after install or settings changes. Trusted project settings in `.pi/settings.json` must not set `compaction.enabled` back to `true`.
 
+## With
+
+This package requires `@henryqw/pi-task-models` for shared compaction routes.
+
+`~/.pi/agent/config/pi-task-models/config.json` is shared and owned by `@henryqw/pi-task-models`. The local `pi-auto-compact/autoCompact` declaration defaults to `fast`. A task entry is an explicit user override.
+
+Malformed shared config is reported and left unchanged. Compaction then uses the current session model.
+
 ## Use
 
-| Surface | Type | Purpose |
-| --- | --- | --- |
-| `/auto-compact` | command | Set the compaction threshold. |
+Use `/auto-compact` to set the compaction threshold.
 
-Refuses to activate unless effective `compaction.enabled` is `false`. Checks `turn_start`, tool-call `turn_end`, `agent_end`, `context`, and resumed or forked `session_start`. Its consumer-owned `pi-auto-compact/autoCompact` task defaults to `fast`. Tries the effective profile primary, then fallback; if neither route works, the current session model still compacts. After mid-task compaction, a follow-up message continues the current task.
+- It refuses to activate unless effective `compaction.enabled` is `false`.
+- It checks `turn_start`, tool-call `turn_end`, `agent_end`, `context`, and resumed or forked `session_start`.
+- Its consumer-owned `pi-auto-compact/autoCompact` task defaults to `fast`.
+- It tries the effective profile primary, then fallback. If neither route works, the current session model still compacts.
+- After mid-task compaction, a follow-up message continues the current task.
 
 ## Config
 
-Package-owned: `~/.pi/agent/config/pi-auto-compact.json`
+Package-owned: `~/.pi/agent/config/pi-auto-compact/config.json`
 
 ```json
 {
@@ -52,10 +54,10 @@ Package-owned: `~/.pi/agent/config/pi-auto-compact.json`
 }
 ```
 
-| Field | Required | Possible values | Default |
-| --- | --- | --- | --- |
-| `autoCompactThreshold` | No | Number, at least 25, below 100 | `50` |
+`autoCompactThreshold` is optional. It must be a number that is at least 25 and below 100. The default is `50`.
+
+Unknown fields are ignored. Legacy model fields are obsolete. `/auto-compact` writes this file.
 
-Unknown fields are ignored (legacy model fields are obsolete). `/auto-compact` writes this file. A missing file uses the default; a malformed or invalid file fails visibly at session start, falls back to 50%, and stays unchanged.
+A missing file uses 50%. Reads do not create it. A malformed or invalid file fails visibly at session start, falls back to 50%, and stays unchanged.
 
-Shared: `~/.pi/agent/config/pi-task-models.json`, owned by `@henryqw/pi-task-models`. The local `pi-auto-compact/autoCompact` declaration defaults to `fast`; a task entry is an explicit user override. Malformed shared task-model config is reported and left unchanged; compaction then uses the current session model.
+Only `/auto-compact` writes this file. Its write is atomic.

package/extensions/auto-compact.ts

@@ -1,11 +1,10 @@
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
 import {
 	compact,
 	estimateTokens,
 	getAgentDir,
 	SettingsManager,
 } from "@earendil-works/pi-coding-agent";
+import { createConfigStore } from "@henryqw/pi-config-store";
 import type {
 	ExtensionAPI,
 	ExtensionContext,
@@ -38,22 +37,13 @@ export const AUTO_COMPACT_TASK = {
 	purpose: "Compact session context before it is exhausted.",
 	defaultProfile: "fast",
 } as const satisfies ModelTask;
-const configPath = () => join(getAgentDir(), "config", "pi-auto-compact.json");
+type AutoCompactConfig = { autoCompactThreshold: number };
 
 function isValidThreshold(value: unknown): value is number {
 	return typeof value === "number" && Number.isFinite(value) && value >= MIN_COMPACT_THRESHOLD_PERCENT && value < 100;
 }
 
-function readConfig(): number {
-	let value: unknown;
-	try {
-		value = JSON.parse(readFileSync(configPath(), "utf8"));
-	} catch (error) {
-		if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
-			return DEFAULT_COMPACT_THRESHOLD_PERCENT;
-		}
-		throw error;
-	}
+function parseAutoCompactConfig(value: unknown): AutoCompactConfig {
 	if (!value || typeof value !== "object" || Array.isArray(value)) {
 		throw new Error("Config must be an object.");
 	}
@@ -61,13 +51,15 @@ function readConfig(): number {
 	if (!isValidThreshold(threshold)) {
 		throw new Error(`autoCompactThreshold must be at least ${MIN_COMPACT_THRESHOLD_PERCENT} and below 100.`);
 	}
-	return threshold;
+	return { autoCompactThreshold: threshold };
 }
 
-function writeConfig(threshold: number): void {
-	const file = configPath();
-	mkdirSync(dirname(file), { recursive: true });
-	writeFileSync(file, `${JSON.stringify({ autoCompactThreshold: threshold }, null, 2)}\n`);
+function createAutoCompactConfigStore() {
+	return createConfigStore<AutoCompactConfig>({
+		extensionId: "pi-auto-compact",
+		defaults: () => ({ autoCompactThreshold: DEFAULT_COMPACT_THRESHOLD_PERCENT }),
+		parse: parseAutoCompactConfig,
+	});
 }
 
 function configuredTaskRoutes(ctx: ExtensionContext): ResolvedTaskRoute[] {
@@ -75,6 +67,7 @@ function configuredTaskRoutes(ctx: ExtensionContext): ResolvedTaskRoute[] {
 		return resolveConfiguredTaskRoutes(ctx, AUTO_COMPACT_TASK);
 	} catch (error) {
 		const { taskRouteCode, profileName } = error as TaskRouteError;
+		if (taskRouteCode === "config-missing") return [];
 		const cause = taskRouteCode === "profile-missing"
 			? `Task model profile ${profileName} is not configured`
 			: taskRouteCode === "no-route"
@@ -155,6 +148,7 @@ function hasToolCall(message: AgentMessage): boolean {
 
 export default function (pi: ExtensionAPI) {
 	registerModelTask(pi, AUTO_COMPACT_TASK);
+	const configStore = createAutoCompactConfigStore();
 	let active = false;
 	let autoCompactThreshold = DEFAULT_COMPACT_THRESHOLD_PERCENT;
 	// Prevent lifecycle hooks from starting duplicate summaries.
@@ -256,7 +250,7 @@ export default function (pi: ExtensionAPI) {
 
 			let currentThreshold: number;
 			try {
-				currentThreshold = readConfig();
+				currentThreshold = configStore.loadSync().value.autoCompactThreshold;
 			} catch {
 				ctx.ui.notify("Couldn't read pi-auto-compact config.", "error");
 				return;
@@ -275,7 +269,7 @@ export default function (pi: ExtensionAPI) {
 			}
 
 			try {
-				writeConfig(threshold);
+				await configStore.save({ autoCompactThreshold: threshold });
 			} catch {
 				ctx.ui.notify("Couldn't save pi-auto-compact config.", "error");
 				return;
@@ -289,7 +283,8 @@ export default function (pi: ExtensionAPI) {
 	// activation unless effective global/project settings disable it.
 	pi.on("session_start", (event, ctx) => {
 		try {
-			autoCompactThreshold = readConfig();
+			const config = configStore.loadSync();
+			autoCompactThreshold = config.value.autoCompactThreshold;
 		} catch {
 			autoCompactThreshold = DEFAULT_COMPACT_THRESHOLD_PERCENT;
 			ctx.ui.notify("Couldn't read pi-auto-compact config; using 50%.", "error");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-auto-compact",
-  "version": "1.1.9",
+  "version": "2.0.0",
   "description": "Proactively compact Pi context at a configurable threshold and resume the current task.",
   "keywords": [
     "pi-package",
@@ -14,9 +14,9 @@
   },
   "license": "MIT",
   "files": [
+    "LICENSE",
     "extensions",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "scripts": {
     "test": "node --test test/*.test.ts",
@@ -44,6 +44,7 @@
     ]
   },
   "dependencies": {
-    "@henryqw/pi-task-models": "^3.0.0"
+    "@henryqw/pi-config-store": "^0.1.0",
+    "@henryqw/pi-task-models": "^4.0.0"
   }
 }