troxy-cli 1.30.21 → 1.30.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "troxy-cli",
-  "version": "1.30.21",
+  "version": "1.30.23",
   "description": "Make your Claude Code usage go further: lighter requests, less usage, less money",
   "homepage": "https://troxy.io",
   "bugs": {

package/src/init.js

@@ -325,14 +325,14 @@ async function printHostedAgentSetup(key) {
 // thing as a bare ~/AGENTS.md, which (per our own testing) a project working
 // directory does not walk up to. This is the one path that actually applies
 // everywhere, so it's the file the "all projects" option below writes to.
-function globalClaudeMdPath() {
+export function globalClaudeMdPath() {
   return path.join(os.homedir(), '.claude', 'CLAUDE.md');
 }
 
 // Same merge algorithm as writeAgentsFile (marker-delimited, never clobbers
 // content outside its own span), generalized to any file path so both the
 // per-project AGENTS.md and the global CLAUDE.md can share it.
-function writeMarkedBlock(file, text, startMarker, endMarker) {
+export function writeMarkedBlock(file, text, startMarker, endMarker) {
   const block = `${startMarker}\n${text}\n${endMarker}`;
   let existing = '';
   try { existing = fs.readFileSync(file, 'utf8'); } catch {}
@@ -352,7 +352,7 @@ function writeMarkedBlock(file, text, startMarker, endMarker) {
   return file;
 }
 
-function removeMarkedBlock(file, startMarker, endMarker) {
+export function removeMarkedBlock(file, startMarker, endMarker) {
   let existing;
   try { existing = fs.readFileSync(file, 'utf8'); } catch { return false; }
   if (!existing.includes(startMarker) || !existing.includes(endMarker)) return false;

package/src/mods/troxy-guard/hooks/register.js

@@ -360,6 +360,22 @@ const COMPACTED = { plugin: 'troxy-guard', key: 'compacted' }; // the band's not
 const COMPACTED_SHOW_MS = 10 * 60 * 1000; // kept through prompts for this long, so it isn't missed
 let compactTimer = null;
 
+// Big-session compaction: a session past 200k compacts right after an answer, between
+// tasks, while its cache is still warm, instead of re-reading the whole thing on every
+// later call. A/B 2026-11-06 at 350k on Sonnet: 4.0 vs 6.0 bar points for the same 9-step
+// job, the compaction included, same results. The short delay lets the turn settle; a
+// prompt typed first cancels it (scorePrompt), so it never holds the user up.
+// Off unless switched on (config bigCompact, or TROXY_BIG_COMPACT=1) until measured live.
+const BIG_COMPACT_TOKENS = 200000;
+const BIG_COMPACT_DELAY_MS = 3000;
+function afterTurnDelay({ tokens, on, off }) {
+  return on && !off && tokens >= BIG_COMPACT_TOKENS ? BIG_COMPACT_DELAY_MS : COMPACT_IDLE_MS;
+}
+async function bigCompactOn($) {
+  if ((await $.env.get('TROXY_BIG_COMPACT')) === '1') return true;
+  return Boolean((await troxyConfig($)).bigCompact);
+}
+
 // What to do when the idle timer fires: skip, compact now, or wait for the meter to reset.
 function compactPlan({ tokens, rateLimits = [], now, off }) {
   if (off || !(tokens >= COMPACT_MIN_TOKENS)) return { action: 'skip' };
@@ -434,7 +450,7 @@ async function idleCompact($, { late = false } = {}) {
   if (r.skip) return;
   const k = n => `${Math.round(n / 1000)}k`;
   await $.state.set(COMPACTED, { at: await $.clock.now(), text: r.tokensBefore && r.tokensAfter
-    ? `compacted this idle session ${k(r.tokensBefore)} → ${k(r.tokensAfter)} tokens` : 'compacted this idle session' });
+    ? `compacted this session ${k(r.tokensBefore)} → ${k(r.tokensAfter)} tokens` : 'compacted this session' });
 }
 
 // Where the local daemon looks for this session's routing note (see interceptor.js).
@@ -681,12 +697,16 @@ export function register(on) {
         if (line) await $.state.set(LINE, line);
       } catch {} // a missed turn only leaves the band as it was
     }
-    let stayAwake = false;
+    let stayAwake = false, delay = COMPACT_IDLE_MS;
     try { stayAwake = await bigSession($); } catch {}
-    armCompact($, COMPACT_IDLE_MS, { stayAwake, persist: true });
+    try {
+      delay = afterTurnDelay({ tokens: ((await $.session.usage()).context || {}).tokens || 0,
+        on: await bigCompactOn($), off: await $.store.get('compactOff') });
+    } catch {}
+    armCompact($, delay, { stayAwake: stayAwake && delay === COMPACT_IDLE_MS, persist: true });
     return r;
   });
 }
 
 // Exported for tests only - not part of the mod's runtime contract.
-export const _internal = { compressedSince, recalledSince, stepEffort, reportRow, noteStep, flushReport, pendingRows: () => pending, troxyConfig, askedFor, rememberAsked, asked, armCompact, cancelCompact, toDomainAndFields, guardBash, failClosed, parseScore, asRequest, pickModel, troxyCommand, modRouteFile, estimateTokens, MODELS, savedLine, sessionLine, addTurn, withKept, statusText, compactPlan, savingsText, fetchSavings, scorePrompt, routeStep, stepModel, lastSent };
+export const _internal = { compressedSince, recalledSince, stepEffort, reportRow, noteStep, flushReport, pendingRows: () => pending, troxyConfig, askedFor, rememberAsked, asked, armCompact, cancelCompact, afterTurnDelay, toDomainAndFields, guardBash, failClosed, parseScore, asRequest, pickModel, troxyCommand, modRouteFile, estimateTokens, MODELS, savedLine, sessionLine, addTurn, withKept, statusText, compactPlan, savingsText, fetchSavings, scorePrompt, routeStep, stepModel, lastSent };

package/src/slim.js

@@ -1,7 +1,7 @@
 import fs   from 'fs';
 import os   from 'os';
 import path from 'path';
-import { claudeCodeSettingsPath } from './init.js';
+import { claudeCodeSettingsPath, globalClaudeMdPath, writeMarkedBlock, removeMarkedBlock } from './init.js';
 import { loadConfig, saveConfig } from './config.js';
 import { api } from './api.js';
 
@@ -21,9 +21,9 @@ import { api } from './api.js';
 // of the tool in a transcript; tool definitions are in transcripts too, so
 // matching the bare name would find every session.
 export const TOOLS = [
-  { id: 'chrome',   label: 'Claude in Chrome (lets Claude control your browser)', tokens: 7200,
+  { id: 'chrome',   label: 'Claude in Chrome (lets Claude control your browser)', tokens: 7200, asks: 'to use or control a web browser',
     used: /"type":"tool_use","id":"[^"]+","name":"mcp__claude-in-chrome__/ },
-  { id: 'artifact', label: 'Artifacts (lets Claude publish pages to claude.ai)', tokens: 7500,
+  { id: 'artifact', label: 'Artifacts (lets Claude publish pages to claude.ai)', tokens: 7500, asks: 'for an artifact or a page published to claude.ai',
     used: /"type":"tool_use","id":"[^"]+","name":"Artifact"/ },
 ];
 
@@ -57,6 +57,23 @@ export function setToolOff(id, off, file = claudeCodeSettingsPath()) {
     throw new Error(`Unknown tool "${id}". Try: ${TOOLS.map(t => t.id).join(', ')}`);
   }
   write(file, s);
+  if (file === claudeCodeSettingsPath()) syncOffNote(file);
+}
+
+const NOTE_START = '<!-- troxy:slim:start -->';
+const NOTE_END   = '<!-- troxy:slim:end -->';
+
+// A turned-off tool is simply gone from Claude's tool list, so nothing errors:
+// Claude would only say it can't do that. This note in the global CLAUDE.md
+// tells Claude why and what to tell the user. About 50 tokens per tool, vs
+// the ~7k the tool itself costs.
+export function syncOffNote(file = claudeCodeSettingsPath(), noteFile = globalClaudeMdPath()) {
+  const off = TOOLS.filter(t => toolIsOff(t.id, file));
+  if (!off.length) { removeMarkedBlock(noteFile, NOTE_START, NOTE_END); return; }
+  writeMarkedBlock(noteFile, '## Turned off by Troxy\n\n' + off.map(t =>
+    `- ${t.label.split(' (')[0]} is turned off by Troxy to make every call smaller. If the user asks you ${t.asks}, ` +
+    `tell them it is off and that they can turn it back on by running \`troxy slim ${t.id} --undo\` in a terminal and then starting a new Claude Code session.`
+  ).join('\n'), NOTE_START, NOTE_END);
 }
 
 export function printToolsStatus(file = claudeCodeSettingsPath()) {
@@ -102,7 +119,9 @@ export async function reportSlim(apiKey = loadConfig()?.apiKey, file = claudeCod
 // back on with --undo stays on.
 export async function autoSlim({ file = claudeCodeSettingsPath(), projectsDir } = {}) {
   const cfg = loadConfig();
-  if (!cfg || cfg.slimChecked) return;
+  if (!cfg) return;
+  if (file === claudeCodeSettingsPath()) syncOffNote(file);  // also for tools turned off before the note existed
+  if (cfg.slimChecked) return;
   const used = usedTools(projectsDir);
   for (const t of TOOLS) {
     if (used.has(t.id) || toolIsOff(t.id, file)) continue;

package/src/tests/mods-troxy-guard.test.js

@@ -113,6 +113,15 @@ test('statusText: version, routing, this session, plan usage, where the account
   assert.match(statusText({ paused: true }), /^Troxy · routing is off\nThis session: nothing moved to a lighter model yet\n/);
 });
 
+test('afterTurnDelay: with bigCompact on, a session past 200k compacts right after the answer', () => {
+  const { afterTurnDelay } = _internal;
+  const IDLE = 55 * 60 * 1000;
+  assert.equal(afterTurnDelay({ tokens: 351000, on: true }), 3000);
+  assert.equal(afterTurnDelay({ tokens: 199000, on: true }), IDLE);             // under 200k: idle path only
+  assert.equal(afterTurnDelay({ tokens: 351000, on: false }), IDLE);            // flag off
+  assert.equal(afterTurnDelay({ tokens: 351000, on: true, off: true }), IDLE);  // /troxy compact off wins
+});
+
 test('compactPlan: big idle sessions compact, small ones and a nearly full bar do not', () => {
   const { compactPlan } = _internal;
   const now = Date.parse('2026-10-08T15:00:00Z');

package/src/tests/slim.test.js

@@ -4,7 +4,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
-import { TOOLS, toolIsOff, setToolOff, usedTools } from '../slim.js';
+import { TOOLS, toolIsOff, setToolOff, usedTools, syncOffNote } from '../slim.js';
 
 // Turning a tool off and back on must leave the user's own settings.json
 // exactly as it was, including their own env vars and deny rules.
@@ -53,4 +53,18 @@ describe('troxy slim', () => {
     assert.deepEqual([...usedTools(path.join(dir, 'projects'))], ['chrome']);
     assert.deepEqual([...usedTools(path.join(dir, 'missing'))], []);
   });
+
+  it('keeps a note for Claude listing only the tools that are off, and keeps the user text', () => {
+    const note = path.join(dir, 'CLAUDE.md');
+    fs.writeFileSync(note, '# mine\n');
+    setToolOff('chrome', true, file);
+    syncOffNote(file, note);
+    let text = fs.readFileSync(note, 'utf8');
+    assert.match(text, /^# mine/);
+    assert.match(text, /troxy slim chrome --undo/);
+    assert.doesNotMatch(text, /troxy slim artifact/);
+    setToolOff('chrome', false, file);
+    syncOffNote(file, note);
+    assert.equal(fs.readFileSync(note, 'utf8').trim(), '# mine');
+  });
 });