@prestyj/cli 4.2.77 → 4.3.34

package/dist/core/auto-update.js

@@ -1,11 +1,11 @@
-import { execSync, spawnSync } from "node:child_process";
+import { spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
 const PACKAGE_NAME = "@prestyj/cli";
 const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
-const CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000; // 4 hours
-const FETCH_TIMEOUT_MS = 3000;
+const CHECK_INTERVAL_MS = 1 * 60 * 60 * 1000; // 1 hour
+const FETCH_TIMEOUT_MS = 10_000; // 10s — npm can be slow
 var PackageManager;
 (function (PackageManager) {
     PackageManager["NPM"] = "npm";
@@ -35,12 +35,6 @@ function writeState(state) {
         // Non-fatal
     }
 }
-function shouldCheck() {
-    const state = readState();
-    if (!state)
-        return true;
-    return Date.now() - state.lastCheckedAt > CHECK_INTERVAL_MS;
-}
 function compareVersions(a, b) {
     const pa = a.split(".").map(Number);
     const pb = b.split(".").map(Number);
@@ -77,76 +71,152 @@ function detectInstallInfo() {
         updateCommand: `npm install -g ${PACKAGE_NAME}@latest`,
     };
 }
-function fetchLatestVersionSync() {
-    // Use a child process to fetch from npm registry with timeout
-    // We use node -e to avoid needing fetch in the parent process synchronously
+/**
+ * Fetch latest version from npm registry asynchronously.
+ */
+async function fetchLatestVersion() {
     try {
-        const script = `
-      const c = new AbortController();
-      const t = setTimeout(() => c.abort(), ${FETCH_TIMEOUT_MS});
-      fetch("${REGISTRY_URL}", { signal: c.signal })
-        .then(r => r.json())
-        .then(d => { clearTimeout(t); process.stdout.write(d.version || ""); })
-        .catch(() => { clearTimeout(t); process.exit(1); });
-    `;
-        const result = spawnSync(process.execPath, ["--input-type=module", "-e", script], {
-            encoding: "utf-8",
-            timeout: FETCH_TIMEOUT_MS + 1000,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-        const version = result.stdout?.trim();
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const response = await fetch(REGISTRY_URL, { signal: controller.signal });
+        clearTimeout(timeout);
+        const data = (await response.json());
+        const version = data.version?.trim();
         return version && /^\d+\.\d+\.\d+/.test(version) ? version : null;
     }
     catch {
         return null;
     }
 }
-function performUpdate(command) {
+/**
+ * Perform the update in a detached background process so it doesn't block
+ * or interfere with the current CLI session. The update takes effect on
+ * the next launch.
+ */
+function performUpdateInBackground(command) {
     try {
-        execSync(command, {
-            stdio: "pipe",
-            timeout: 60_000,
+        const parts = command.split(" ");
+        const child = spawn(parts[0], parts.slice(1), {
+            detached: true,
+            stdio: "ignore",
             env: { ...process.env, npm_config_loglevel: "silent" },
         });
-        return true;
+        child.unref();
     }
     catch {
-        return false;
+        // Non-fatal — will retry next startup
     }
 }
 /**
- * Check for updates and silently auto-update if a newer version is available.
- * Called at CLI startup. Non-blocking on failure — the CLI always proceeds.
+ * Check for updates at CLI startup. Two-phase approach:
+ *
+ * Phase 1 (instant): If a previous background check found a newer version,
+ *   kick off a background update now. Non-blocking.
  *
- * Returns a message to display if an update happened, or null.
+ * Phase 2 (async): Fire off a background version check for the *next* startup.
+ *
+ * Returns a message to display, or null.
  */
 export function checkAndAutoUpdate(currentVersion) {
     try {
-        if (!shouldCheck())
-            return null;
-        const latestVersion = fetchLatestVersionSync();
-        // Always record that we checked
-        writeState({
-            lastCheckedAt: Date.now(),
-            lastSeenVersion: latestVersion ?? undefined,
-        });
-        if (!latestVersion)
-            return null;
-        if (compareVersions(latestVersion, currentVersion) <= 0)
-            return null;
-        const info = detectInstallInfo();
-        if (!info.updateCommand)
-            return null;
-        const success = performUpdate(info.updateCommand);
-        if (success) {
-            return `Updated ${PACKAGE_NAME} ${currentVersion} \u2192 ${latestVersion}`;
+        const state = readState();
+        let message = null;
+        // Phase 1: Apply pending update from previous check
+        if (state?.updatePending && state.latestVersion) {
+            if (compareVersions(state.latestVersion, currentVersion) > 0) {
+                const info = detectInstallInfo();
+                if (info.updateCommand) {
+                    // Run update in background — takes effect next launch
+                    performUpdateInBackground(info.updateCommand);
+                    message = `Updating ${PACKAGE_NAME} ${currentVersion} → ${state.latestVersion} (takes effect next launch)`;
+                    writeState({
+                        ...state,
+                        lastCheckedAt: Date.now(),
+                        updatePending: false,
+                        lastUpdateAttempt: Date.now(),
+                    });
+                }
+            }
+            else {
+                // Already on latest (user may have updated manually)
+                writeState({ ...state, updatePending: false });
+            }
         }
-        // Update failed — show manual instructions
-        return `Update available: ${currentVersion} \u2192 ${latestVersion}\nRun: ${info.updateCommand}`;
+        // Phase 2: Schedule background check for next startup
+        const shouldCheck = !state || Date.now() - state.lastCheckedAt > CHECK_INTERVAL_MS;
+        if (shouldCheck) {
+            scheduleBackgroundCheck(currentVersion);
+        }
+        return message;
     }
     catch {
-        // Never block CLI startup
         return null;
     }
 }
+/**
+ * Fire-and-forget async version check. Updates the state file so the
+ * next startup knows whether an update is available.
+ */
+function scheduleBackgroundCheck(currentVersion) {
+    fetchLatestVersion()
+        .then((latestVersion) => {
+        const newState = {
+            lastCheckedAt: Date.now(),
+            latestVersion: latestVersion ?? undefined,
+            updatePending: false,
+        };
+        if (latestVersion && compareVersions(latestVersion, currentVersion) > 0) {
+            newState.updatePending = true;
+        }
+        writeState(newState);
+    })
+        .catch(() => {
+        // Non-fatal — will retry next time
+    });
+}
+// ── In-session periodic check ──────────────────────────────────────────
+let periodicTimer = null;
+/**
+ * Start periodic update checks during a long-running session.
+ * Checks every hour. If an update is found, calls `onUpdate` with a message.
+ */
+export function startPeriodicUpdateCheck(currentVersion, onUpdate) {
+    if (periodicTimer)
+        return; // Already running
+    periodicTimer = setInterval(() => {
+        fetchLatestVersion()
+            .then((latestVersion) => {
+            if (!latestVersion)
+                return;
+            if (compareVersions(latestVersion, currentVersion) <= 0)
+                return;
+            const info = detectInstallInfo();
+            if (!info.updateCommand)
+                return;
+            // Mark pending for next startup
+            writeState({
+                lastCheckedAt: Date.now(),
+                latestVersion,
+                updatePending: true,
+            });
+            onUpdate(`Update available: ${currentVersion} → ${latestVersion} (will update on next launch, or run: ${info.updateCommand})`);
+            // Stop checking once we've notified
+            stopPeriodicUpdateCheck();
+        })
+            .catch(() => {
+            // Non-fatal
+        });
+    }, CHECK_INTERVAL_MS);
+    // Don't keep the process alive just for update checks
+    periodicTimer.unref();
+}
+/**
+ * Stop periodic update checks.
+ */
+export function stopPeriodicUpdateCheck() {
+    if (periodicTimer) {
+        clearInterval(periodicTimer);
+        periodicTimer = null;
+    }
+}
 //# sourceMappingURL=auto-update.js.map

package/dist/core/auto-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.js","sourceRoot":"","sources":["../../src/core/auto-update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auto-update.js","sourceRoot":"","sources":["../../src/core/auto-update.ts"],"names":[],"mappings":"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"}

package/dist/core/auto-update.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auto-update.test.d.ts.map

package/dist/core/auto-update.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.test.d.ts","sourceRoot":"","sources":["../../src/core/auto-update.test.ts"],"names":[],"mappings":""}

package/dist/core/auto-update.test.js

@@ -0,0 +1,205 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { checkAndAutoUpdate, startPeriodicUpdateCheck, stopPeriodicUpdateCheck, } from "./auto-update.js";
+// Use a temp directory for state file instead of the real ~/.gg
+const tmpDir = path.join(os.tmpdir(), `gg-update-test-${process.pid}`);
+// Mock the state file path
+vi.mock("node:os", async () => {
+    const actual = await vi.importActual("node:os");
+    return {
+        ...actual,
+        default: {
+            ...actual,
+            homedir: () => tmpDir,
+        },
+    };
+});
+// Mock spawn so we never actually run install commands
+vi.mock("node:child_process", () => ({
+    spawn: vi.fn(() => ({ unref: vi.fn() })),
+}));
+function writeStateFile(state) {
+    fs.mkdirSync(path.join(tmpDir, ".ezcoder"), { recursive: true });
+    fs.writeFileSync(path.join(tmpDir, ".ezcoder", "update-state.json"), JSON.stringify(state));
+}
+function readStateFile() {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(tmpDir, ".ezcoder", "update-state.json"), "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+beforeEach(() => {
+    fs.mkdirSync(path.join(tmpDir, ".ezcoder"), { recursive: true });
+    // Clear any existing state
+    try {
+        fs.unlinkSync(path.join(tmpDir, ".ezcoder", "update-state.json"));
+    }
+    catch {
+        // fine
+    }
+    vi.restoreAllMocks();
+});
+afterEach(() => {
+    stopPeriodicUpdateCheck();
+    vi.restoreAllMocks();
+    try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch {
+        // fine
+    }
+});
+describe("checkAndAutoUpdate", () => {
+    it("returns null on first run with no state file", () => {
+        // Mock fetch to return a version (but the background check is async, so
+        // on first call it just schedules a check and returns null)
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "99.0.0" }),
+        }));
+        const result = checkAndAutoUpdate("1.0.0");
+        expect(result).toBeNull();
+    });
+    it("returns null when already on latest version", () => {
+        writeStateFile({
+            lastCheckedAt: Date.now(),
+            latestVersion: "1.0.0",
+            updatePending: true,
+        });
+        const result = checkAndAutoUpdate("1.0.0");
+        expect(result).toBeNull();
+        // Should clear the pending flag
+        const state = readStateFile();
+        expect(state?.updatePending).toBe(false);
+    });
+    it("returns null when on a newer version than registry (manual install)", () => {
+        writeStateFile({
+            lastCheckedAt: Date.now(),
+            latestVersion: "1.0.0",
+            updatePending: true,
+        });
+        const result = checkAndAutoUpdate("2.0.0");
+        expect(result).toBeNull();
+        const state = readStateFile();
+        expect(state?.updatePending).toBe(false);
+    });
+    it("triggers background update when pending update exists", () => {
+        writeStateFile({
+            lastCheckedAt: Date.now(),
+            latestVersion: "2.0.0",
+            updatePending: true,
+        });
+        const result = checkAndAutoUpdate("1.0.0");
+        expect(result).toContain("Updating");
+        expect(result).toContain("1.0.0");
+        expect(result).toContain("2.0.0");
+        expect(vi.mocked(spawn)).toHaveBeenCalled();
+        // Should clear the pending flag
+        const state = readStateFile();
+        expect(state?.updatePending).toBe(false);
+        expect(state?.lastUpdateAttempt).toBeDefined();
+    });
+    it("schedules background check when last check was long ago", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "5.0.0" }),
+        });
+        vi.stubGlobal("fetch", fetchMock);
+        writeStateFile({
+            lastCheckedAt: 0, // very old
+            latestVersion: "1.0.0",
+            updatePending: false,
+        });
+        checkAndAutoUpdate("1.0.0");
+        // Give the async check time to complete
+        await vi.waitFor(() => {
+            expect(fetchMock).toHaveBeenCalled();
+        });
+        // Wait for the state to be written
+        await vi.waitFor(() => {
+            const state = readStateFile();
+            expect(state?.latestVersion).toBe("5.0.0");
+            expect(state?.updatePending).toBe(true);
+        });
+    });
+    it("does not schedule check when recently checked", () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "5.0.0" }),
+        });
+        vi.stubGlobal("fetch", fetchMock);
+        writeStateFile({
+            lastCheckedAt: Date.now(), // just now
+            latestVersion: "1.0.0",
+            updatePending: false,
+        });
+        checkAndAutoUpdate("1.0.0");
+        // fetch should NOT be called since we just checked
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+    it("handles fetch failure gracefully", async () => {
+        const fetchMock = vi.fn().mockRejectedValue(new Error("network error"));
+        vi.stubGlobal("fetch", fetchMock);
+        writeStateFile({
+            lastCheckedAt: 0,
+            updatePending: false,
+        });
+        // Should not throw
+        const result = checkAndAutoUpdate("1.0.0");
+        expect(result).toBeNull();
+    });
+    it("handles corrupt state file gracefully", () => {
+        fs.writeFileSync(path.join(tmpDir, ".ezcoder", "update-state.json"), "not json{{{");
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "2.0.0" }),
+        }));
+        // Should not throw — treats corrupt file like no file
+        const result = checkAndAutoUpdate("1.0.0");
+        expect(result).toBeNull();
+    });
+});
+describe("startPeriodicUpdateCheck", () => {
+    it("calls onUpdate when a newer version is found", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "99.0.0" }),
+        }));
+        const onUpdate = vi.fn();
+        vi.useFakeTimers();
+        startPeriodicUpdateCheck("1.0.0", onUpdate);
+        // Advance past one check interval
+        await vi.advanceTimersByTimeAsync(1 * 60 * 60 * 1000 + 100);
+        expect(onUpdate).toHaveBeenCalledWith(expect.stringContaining("99.0.0"));
+        vi.useRealTimers();
+    });
+    it("does not call onUpdate when already on latest", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "1.0.0" }),
+        }));
+        const onUpdate = vi.fn();
+        vi.useFakeTimers();
+        startPeriodicUpdateCheck("1.0.0", onUpdate);
+        await vi.advanceTimersByTimeAsync(1 * 60 * 60 * 1000 + 100);
+        expect(onUpdate).not.toHaveBeenCalled();
+        vi.useRealTimers();
+    });
+    it("stops checking after first notification", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            json: () => Promise.resolve({ version: "99.0.0" }),
+        });
+        vi.stubGlobal("fetch", fetchMock);
+        const onUpdate = vi.fn();
+        vi.useFakeTimers();
+        startPeriodicUpdateCheck("1.0.0", onUpdate);
+        // First interval
+        await vi.advanceTimersByTimeAsync(1 * 60 * 60 * 1000 + 100);
+        expect(onUpdate).toHaveBeenCalledTimes(1);
+        // Second interval — should NOT fire again (timer stopped)
+        fetchMock.mockClear();
+        await vi.advanceTimersByTimeAsync(1 * 60 * 60 * 1000 + 100);
+        expect(fetchMock).not.toHaveBeenCalled();
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=auto-update.test.js.map

package/dist/core/auto-update.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.test.js","sourceRoot":"","sources":["../../src/core/auto-update.test.ts"],"names":[],"mappings":"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"}

package/dist/core/compaction/compactor.d.ts

@@ -1,16 +1,33 @@
 import { type Message, type Provider, type ContentPart } from "@prestyj/ai";
 export interface CompactionResult {
+    /** Whether messages were actually reduced. */
+    compacted: boolean;
+    /** Why compaction was skipped (only set when compacted is false). */
+    reason?: string;
     originalCount: number;
     newCount: number;
     tokensBeforeEstimate: number;
     tokensAfterEstimate: number;
 }
+/**
+ * Default token reserve for compaction.
+ * Leaves headroom for the model's next response + system overhead.
+ * Matches the widely-used Pi / Grok-CLI default of 16 384 tokens.
+ */
+export declare const COMPACTION_RESERVE_TOKENS = 16384;
 /**
  * Check if compaction should be triggered.
+ *
+ * Uses the reserve-based approach (contextWindow − reserveTokens) used by
+ * Pi, Grok-CLI, OpenClaw, BrowserOS, and most real-world agent frameworks.
+ * A percentage-based threshold is still supported: when both are supplied the
+ * more conservative (lower) limit wins.
  */
 export declare function shouldCompact(messages: Message[], contextWindow: number, threshold?: number, 
 /** Actual API-reported token count — preferred over char-based estimate when available. */
-actualTokens?: number): boolean;
+actualTokens?: number, 
+/** Fixed token reserve subtracted from contextWindow. Defaults to 16 384. */
+reserveTokens?: number): boolean;
 /**
  * Find the index where recent messages should start, given a token budget.
  * Walks backward from the end, accumulating token estimates, and returns the

package/dist/core/compaction/compactor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/compactor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAwCrB,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAM;AACf,2FAA2F;AAC3F,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAMT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA4CnF;AAiED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CA6CpE;AAqID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAkBtF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,OAAO,EAAE,EACzB,OAAO,EAAE;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GACpD,MAAM,CAgCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,MAAM,CAM1E;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE;IACP,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAiO5D"}
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/compactor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAwCrB,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAKhD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAM;AACf,2FAA2F;AAC3F,YAAY,CAAC,EAAE,MAAM;AACrB,6EAA6E;AAC7E,aAAa,SAA4B,GACxC,OAAO,CAoBT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA4CnF;AAiED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CA6CpE;AAqID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAkBtF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,OAAO,EAAE,EACzB,OAAO,EAAE;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GACpD,MAAM,CAgCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,MAAM,CAM1E;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE;IACP,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAiP5D"}

package/dist/core/compaction/compactor.js

@@ -30,14 +30,42 @@ const COMPACTION_SYSTEM_PROMPT = "You are a conversation compaction assistant. Y
     "Focus on technical precision. Include specific identifiers (file paths, function names, etc.) " +
     "that would be essential for continuation. Write in third person and maintain an objective, technical tone.";
 const COMPACTION_USER_PROMPT = "Summarize the conversation above into a concise summary following the instructions. Output only the summary, nothing else.";
+/**
+ * Default token reserve for compaction.
+ * Leaves headroom for the model's next response + system overhead.
+ * Matches the widely-used Pi / Grok-CLI default of 16 384 tokens.
+ */
+export const COMPACTION_RESERVE_TOKENS = 16_384;
+/** Minimum messages before compaction is attempted (Mysti uses 4). */
+const COMPACTION_MIN_MESSAGES = 4;
 /**
  * Check if compaction should be triggered.
+ *
+ * Uses the reserve-based approach (contextWindow − reserveTokens) used by
+ * Pi, Grok-CLI, OpenClaw, BrowserOS, and most real-world agent frameworks.
+ * A percentage-based threshold is still supported: when both are supplied the
+ * more conservative (lower) limit wins.
  */
 export function shouldCompact(messages, contextWindow, threshold = 0.8, 
 /** Actual API-reported token count — preferred over char-based estimate when available. */
-actualTokens) {
+actualTokens, 
+/** Fixed token reserve subtracted from contextWindow. Defaults to 16 384. */
+reserveTokens = COMPACTION_RESERVE_TOKENS) {
+    // Don't attempt compaction with too few messages — compact() would bail
+    // anyway (middleMessages <= 2), but this avoids the spinner + LLM auth dance.
+    // Skip the guard when actualTokens is provided (force-compact / overflow paths
+    // where the caller has precise token info regardless of message count).
+    if (actualTokens == null && messages.length < COMPACTION_MIN_MESSAGES) {
+        log("INFO", "compaction", `Context check: skipping — only ${messages.length} messages`);
+        return false;
+    }
     const estimated = actualTokens ?? estimateConversationTokens(messages);
-    const limit = contextWindow * threshold;
+    const percentageLimit = contextWindow * threshold;
+    // Only apply the fixed reserve when the context window is large enough
+    // that the reserve is meaningful (< 50% of the window).
+    const limit = reserveTokens > 0 && reserveTokens < contextWindow * 0.5
+        ? Math.min(percentageLimit, contextWindow - reserveTokens)
+        : percentageLimit;
     const source = actualTokens != null ? "actual" : "estimated";
     log("INFO", "compaction", `Context check: ${estimated} ${source} tokens, threshold ${limit}`);
     return estimated > limit;
@@ -426,6 +454,8 @@ export async function compact(messages, options) {
         return {
             messages: [...messages],
             result: {
+                compacted: false,
+                reason: "too_few_messages",
                 originalCount,
                 newCount: messages.length,
                 tokensBeforeEstimate,
@@ -543,13 +573,21 @@ export async function compact(messages, options) {
         role: "user",
         content: `[Previous conversation summary]\n\n${summaryText}${fileTrackingSection}`,
     };
+    // Skip the assistant ack when recentMessages starts with an assistant message
+    // to prevent consecutive assistant messages that the Anthropic API rejects.
+    // This happens when findRecentCutPoint backs up from a tool to an assistant.
+    const skipAck = recentMessages.length > 0 && recentMessages[0].role === "assistant";
     const newMessages = [
         systemMessage,
         summaryMessage,
-        {
-            role: "assistant",
-            content: "Understood — I have the context from what was discussed earlier.",
-        },
+        ...(skipAck
+            ? []
+            : [
+                {
+                    role: "assistant",
+                    content: "Understood — I have the context from what was discussed earlier.",
+                },
+            ]),
         ...recentMessages,
     ];
     // Repair tool_use / tool_result pairing in the final message array.
@@ -562,7 +600,9 @@ export async function compact(messages, options) {
     // But never pop below 3 messages (system + summary + ack) — removing the
     // compaction ack would leave only the summary, causing `ezcoder continue`
     // to restore just 1 message instead of the full session.
-    while (newMessages.length > 3 && newMessages[newMessages.length - 1].role === "assistant") {
+    const minMessages = skipAck ? 2 : 3;
+    while (newMessages.length > minMessages &&
+        newMessages[newMessages.length - 1].role === "assistant") {
         newMessages.pop();
     }
     const tokensAfterEstimate = estimateConversationTokens(newMessages);
@@ -581,6 +621,7 @@ export async function compact(messages, options) {
     return {
         messages: newMessages,
         result: {
+            compacted: true,
             originalCount,
             newCount: newMessages.length,
             tokensBeforeEstimate,