@henryqw/pi-auto-compact 2.0.2 → 2.0.4

package/README.md

@@ -1,19 +1,23 @@
 # `@henryqw/pi-auto-compact`
 
-Compact context before it reaches the configured threshold. Then resume the current task.
+Compact Pi context at your chosen threshold, then continue the interrupted task automatically.
 
 ## Why
 
-- **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.
+- **Created for**: Long Pi sessions that need predictable context headroom.
+- **Advantage**: Compact early through a shared model route, without making users restart the task.
 
 ## Install
 
+Install the required Task Models extension first:
+
 ```bash
 pi install npm:@henryqw/pi-task-models
 pi install npm:@henryqw/pi-auto-compact
 ```
 
+Run `/task-models` and configure the `fast` profile. Open `/task-models` again to verify that `fast` no longer says `not configured`.
+
 Disable Pi's built-in auto-compaction in `~/.pi/agent/settings.json`:
 
 ```json
@@ -24,11 +28,13 @@ 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`.
+Restart Pi after install or settings changes. Trusted `.pi/settings.json` files must not set `compaction.enabled` back to `true`.
+
+Run `/auto-compact`, enter a threshold, and expect `Auto-compact threshold set to <value>%.`
 
 ## With
 
-This package requires `@henryqw/pi-task-models` for shared compaction routes.
+This package requires [`@henryqw/pi-task-models`](https://pi.henry.wang/extensions/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.
 
@@ -42,7 +48,7 @@ Use `/auto-compact` to set the compaction threshold.
 - 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.
+- After mid-task compaction, it resumes the current task automatically.
 
 ## Config
 

package/extensions/auto-compact.ts

@@ -27,7 +27,7 @@ type AgentMessage = Parameters<typeof estimateTokens>[0];
  * - context: last-resort guard with a temporary keep-recent context.
  *
  * Pi's ctx.compact() aborts active low-level run internally. Mid-task
- * compaction sends a follow-up user message to resume work after summary.
+ * compaction sends a custom continuation message after summary.
  */
 const DEFAULT_COMPACT_THRESHOLD_PERCENT = 70;
 const MIN_COMPACT_THRESHOLD_PERCENT = 25;
@@ -87,6 +87,7 @@ function withoutDeletedHeaders(headers: Record<string, string | null> | undefine
 // Emergency context guard keeps recent messages while default compaction runs.
 const KEEP_RECENT_PERCENT = 15;
 const COMPACTION_INSTRUCTIONS = "Preserve current task to be resumed after compaction.";
+const RESUME_MESSAGE_TYPE = "pi-auto-compact/resume";
 const RESUME_MESSAGE = "Auto-compact ran. Continue the current task.";
 const COMPACTION_ABORT_ERROR = "This operation was aborted";
 const ACTIVATION_ERROR =
@@ -166,7 +167,12 @@ export default function (pi: ExtensionAPI) {
 				// Pi may flush queued input during compaction_end. Wait one macrotask
 				// before checking idle, otherwise follow-up can race that flush.
 				setImmediate(() => {
-					if (ctx.isIdle()) pi.sendUserMessage(RESUME_MESSAGE);
+					if (!ctx.isIdle()) return;
+					pi.sendMessage({
+						customType: RESUME_MESSAGE_TYPE,
+						content: RESUME_MESSAGE,
+						display: false,
+					}, { triggerTurn: true });
 				});
 			},
 			onError: () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-auto-compact",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Proactively compact Pi context at a configurable threshold and resume the current task.",
   "keywords": [
     "pi-package",