terminal-smart-cli 0.97.8 → 0.97.10

package/lib/agent.js

@@ -13,6 +13,7 @@ const policy = require('./policy');
 const checkpoint = require('./checkpoint');
 const skillIndex = require('./skill-index');
 const tools = require('./tools');
+const { MissionToolCache, cacheReference } = require('./mission-tool-cache');
 
 // SKILLS INSTALADAS (~/.ts/skills/<slug>/SKILL.md): lê nome+descrição do frontmatter pra
 // oferecer ao agente. O agente LÊ o SKILL.md completo (com ler_arquivo) quando a skill é útil.
@@ -494,6 +495,7 @@ async function run(task, opts = {}) {
   // ação (mesmo comando falhando, ciclo A/B/A/B). WARN = empurra a mudar de abordagem; 2º strike
   // (ou já avisado e ainda em ciclo) = encerra o loop e cai no fechamento honesto garantido.
   const _callCounts = new Map(); const _recentSigs = []; const _warnedSigs = new Set();
+  const _missionCache = new MissionToolCache();
   let _loopWarned = false, loopedOut = false;
   const LOOP_WARN = Number(process.env.TS_LOOP_WARN) > 0 ? Number(process.env.TS_LOOP_WARN) : 3;
   const LOOP_BREAK = Number(process.env.TS_LOOP_BREAK) > 0 ? Number(process.env.TS_LOOP_BREAK) : 5;
@@ -675,6 +677,7 @@ async function run(task, opts = {}) {
       const name = (tc.function && tc.function.name) || '';
       let input = {}; try { input = JSON.parse((tc.function && tc.function.arguments) || '{}'); } catch (_) {}
       let result;
+      let _cachedContent = '';
       let _ran = false; // true só quando uma ferramenta REALMENTE executou (não gate/bloqueio) → status ✓/✗
 
       guardStopped = _guard();
@@ -971,6 +974,16 @@ async function run(task, opts = {}) {
         result = { resumo: sub.resumo };
         steps++; _ran = true;
       }
+      if (result === undefined && READONLY.has(name)) {
+        const _cached = _missionCache.get(name, input);
+        if (_cached) {
+          const _visible = messages.some(m => m && m.role === 'tool' && m.tool_call_id === _cached.toolCallId);
+          _cachedContent = cacheReference(_cached, name, _visible);
+          if (_visible) _missionCache.recordSavings(Math.max(0, String(_cached.content || '').length - _cachedContent.length));
+          result = { cached: true, tool: name };
+          onStep({ name, detail: 'cache da missão: ' + argsShort(name, input) });
+        }
+      }
       if (result === undefined) {
         onStep({ name, detail: argsShort(name, input) });
         result = await tools.execute(name, input, { confineDir, baseDir: cwd, token, allowedTools: _allowedToolNames });
@@ -1023,6 +1036,12 @@ async function run(task, opts = {}) {
         if (result && (result._backup !== undefined || result._acao !== undefined)) {
           result = Object.assign({}, result); delete result._backup; delete result._acao;
         }
+        const _cacheClass = core.classifyToolResult(result);
+        if (_cacheClass.ok && READONLY.has(name)) {
+          _missionCache.remember(name, input, { toolCallId: tc.id, content: JSON.stringify(result).slice(0, TOOL_RESULT_CAP) });
+        } else if (_cacheClass.ok && !READONLY.has(name)) {
+          _missionCache.invalidate();
+        }
       }
       // AVISO SUAVE de convergência: a partir de 2/3 do teto de pesquisa, empurra o modelo a
       // concluir (o limite DURO acima corta de vez; este só sinaliza antes, sem bloquear).
@@ -1042,7 +1061,7 @@ async function run(task, opts = {}) {
         _logEp('human');
         return { text: finalText, steps, credits: charged + _visionCredits, tokens: acc, model: usedModel, actions, cwd, context: lastCtx, needHuman: { motivo: result.motivo, o_que_fazer: result.o_que_fazer } };
       }
-      messages.push({ role: 'tool', tool_call_id: tc.id, content: JSON.stringify(result).slice(0, TOOL_RESULT_CAP) });
+      messages.push({ role: 'tool', tool_call_id: tc.id, content: _cachedContent || JSON.stringify(result).slice(0, TOOL_RESULT_CAP) });
       if (guardStopped) break;
     }
     if (loopedOut || guardStopped) break; // watchdog/trava de orçamento cortou → fechamento determinístico
@@ -1124,6 +1143,10 @@ async function run(task, opts = {}) {
     const _syncTasks = [
       _memoryBus.recordContext(token, _snapshot),
       _memoryBus.saveHandoff(token, _handoff),
+      api('/api/telemetry/mission-cache', {
+        method: 'POST', token, timeoutMs: 3000, retry: false,
+        body: Object.assign({ surface: 'cli', model: usedModel }, _missionCache.stats()),
+      }),
     ];
     if (usedModel && usedModel !== 'smart') _syncTasks.push(api('/api/intelligence/observe', {
         method: 'POST',

package/lib/mission-tool-cache.js

@@ -0,0 +1,57 @@
+'use strict';
+
+function stable(value) {
+  if (Array.isArray(value)) return value.map(stable);
+  if (value && typeof value === 'object') {
+    const out = {};
+    for (const key of Object.keys(value).sort()) out[key] = stable(value[key]);
+    return out;
+  }
+  return value;
+}
+
+function signature(tool, input) {
+  return String(tool || '') + '|' + JSON.stringify(stable(input || {}));
+}
+
+class MissionToolCache {
+  constructor({ maxEntries = 64 } = {}) {
+    this.maxEntries = Math.max(1, maxEntries);
+    this.entries = new Map();
+    this.hits = 0;
+    this.invalidations = 0;
+    this.charactersSaved = 0;
+  }
+  get(tool, input) {
+    const key = signature(tool, input);
+    const entry = this.entries.get(key);
+    if (!entry) return null;
+    this.entries.delete(key); this.entries.set(key, entry);
+    this.hits++;
+    return entry;
+  }
+  remember(tool, input, entry) {
+    const key = signature(tool, input);
+    this.entries.delete(key);
+    this.entries.set(key, Object.assign({}, entry));
+    while (this.entries.size > this.maxEntries) this.entries.delete(this.entries.keys().next().value);
+  }
+  invalidate() {
+    if (this.entries.size) this.invalidations++;
+    this.entries.clear();
+  }
+  recordSavings(characters) { this.charactersSaved += Math.max(0, Number(characters) || 0); }
+  stats() { return { entries: this.entries.size, hits: this.hits, invalidations: this.invalidations, charactersSaved: this.charactersSaved, estimatedTokensSaved: Math.ceil(this.charactersSaved / 4) }; }
+}
+
+function cacheReference(entry, tool, originalStillVisible) {
+  if (!originalStillVisible && entry && entry.content) return entry.content;
+  return JSON.stringify({
+    cached: true,
+    tool,
+    message: 'Resultado idêntico já fornecido nesta missão; a fonte não foi consultada novamente. Use o resultado anterior.',
+    originalToolCallId: entry && entry.toolCallId,
+  });
+}
+
+module.exports = { MissionToolCache, signature, cacheReference };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-smart-cli",
-  "version": "0.97.8",
+  "version": "0.97.10",
   "description": "Terminal Smart no seu terminal — pergunte, analise logs por pipe e orquestre agentes de IA. Comando: ts",
   "bin": {
     "ts": "bin/ts.js"