agy-insights 0.9.0 → 0.9.1

package/README.es.md

@@ -36,7 +36,7 @@ npx agy-insights
 npx agy-insights@latest --text
 ```
 
-`@latest` hace que npx compruebe cada vez si hay una versión nueva. Sin él, una copia instalada globalmente (`npm install -g`) o en el proyecto actual tiene prioridad y no se actualiza nunca. Para fijar una versión concreta: `npx agy-insights@0.9.0`.
+`@latest` hace que npx compruebe cada vez si hay una versión nueva. Sin él, una copia instalada globalmente (`npm install -g`) o en el proyecto actual tiene prioridad y no se actualiza nunca. Para fijar una versión concreta: `npx agy-insights@0.9.1`.
 
 **Instalándolo globalmente:**
 
@@ -78,11 +78,11 @@ Analiza todo tu historial (todas las conversaciones que guarde agy, sin límite
 El informe da dos cifras:
 
 - **Consumo real**: los tokens que Antigravity anota en el registro de cada conversación (`~/.gemini/antigravity-cli/brain/<id>/.system_generated/logs/transcript.jsonl`), subagentes incluidos. Se muestra sin caché y con caché, porque no sabemos si la cuota cuenta igual la caché. Es la cifra que sirve para comparar entre compañeros.
-- **«~tokens»**: estimados a partir del tamaño guardado de cada paso. Sirven para comparar qué ficheros, carpetas o comandos pesan más, pero se quedan cortos frente al consumo real, porque cada llamada al modelo vuelve a enviar el contexto acumulado.
+- **«~tokens»**: estimados a partir del tamaño guardado de cada paso. Sirven para comparar qué ficheros, carpetas o comandos pesan más, pero se quedan cortos frente al consumo real, porque cada llamada al modelo vuelve a enviar el contexto acumulado. Las imágenes (capturas de pantalla, por ejemplo) se estiman por su tamaño en píxeles, como las cuenta Gemini (258 tokens por bloque de 768 px), y no por sus bytes.
 
 ## Leer el informe
 
-Arriba están el selector de periodo y los totales. Después, una gráfica de **consumo de tokens por día** (por semana si el historial pasa de ~4 meses) para ver la evolución. Cámbiala a **Por llamada** para ver los tokens medios de cada llamada al modelo: el total sube y baja según cuánto hayas trabajado, mientras que por llamada solo baja si cada llamada lleva menos contexto, así que es la que muestra si un cambio ha servido. Pasa el ratón por una columna para ver sus cifras, o abre «Ver como tabla». Si usas el CLI y también el editor o la extensión de VS Code, **Por origen** reparte las conversaciones y los tokens reales entre ellos (el editor y la extensión comparten historial, así que cuentan juntos), y cada sesión indica desde dónde se tuvo. Después, **Modelos y esfuerzo**: llamadas y tokens reales por modelo y nivel de esfuerzo (por ejemplo Gemini 3.8 Flash · Alto), con los tokens por llamada, para ver cuánto cuesta un esfuerzo mayor. Debajo, **Qué está pasando** reúne los hallazgos; al final, el detalle por proyecto, tipo de fichero, carpeta, fichero, herramienta y comando. El proyecto de cada fichero se detecta por su carpeta `.git`.
+Arriba están el selector de periodo y los totales. Después, una gráfica de **consumo de tokens por día** (por semana si el historial pasa de ~4 meses) para ver la evolución. Cámbiala a **Por llamada** para ver los tokens medios de cada llamada al modelo: el total sube y baja según cuánto hayas trabajado, mientras que por llamada solo baja si cada llamada lleva menos contexto, así que es la que muestra si un cambio ha servido. Pasa el ratón por una columna para ver sus cifras, o abre «Ver como tabla». Si usas el CLI y también el IDE de Antigravity, su app o una extensión de editor como la de VS Code, **Por origen** reparte las conversaciones y los tokens reales entre «CLI» e «IDE y extensiones» (estos comparten historial, así que cuentan juntos), y cada sesión indica desde dónde se tuvo. Después, **Modelos y esfuerzo**: llamadas y tokens reales por modelo y nivel de esfuerzo (por ejemplo Gemini 3.8 Flash · Alto), con los tokens por llamada, para ver cuánto cuesta un esfuerzo mayor. Debajo, **Qué está pasando** reúne los hallazgos; al final, el detalle por proyecto, tipo de fichero, carpeta, fichero, herramienta y comando. El proyecto de cada fichero se detecta por su carpeta `.git`.
 
 | Hallazgo | Qué significa | Qué hacer |
 |---|---|---|
@@ -98,7 +98,10 @@ Despliega **Cómo excluirlo** en una propuesta. Verás el fichero exacto, dónde
 
 ### 1. Denegar la lectura (permiso de Antigravity)
 
-Es lo único que impide de verdad que el agente lea una ruta. Usa los [permisos oficiales](https://antigravity.google/docs/permissions).
+Es lo único que impide de verdad que el agente lea una ruta. Usa los [permisos oficiales](https://antigravity.google/docs/permissions). Dónde va la regla depende de qué Antigravity leyó el fichero, y el informe propone el sitio correcto:
+
+- **IDE, app o extensión de editor** (como la de VS Code): no tienen un fichero de ajustes que editar. Añade la regla (`read_file(<ruta>)`) como regla de denegación en sus **Settings → Permission Grants**, para todos los proyectos o para uno.
+- **CLI (`agy`)**:
 
 1. Abre `~/.gemini/antigravity-cli/settings.json` (en Windows, `%USERPROFILE%\.gemini\antigravity-cli\settings.json`).
 2. Pega la regla dentro de `"permissions"` → `"deny"`. Si no existen, créalas; si existen, añade la regla sin borrar nada:
@@ -116,7 +119,7 @@ Es lo único que impide de verdad que el agente lea una ruta. Usa los [permisos
 
 3. Guarda y reinicia `agy`.
 
-Denegar la lectura de una ruta también impide escribir en ella, y la regla vale para todos tus proyectos. Úsala para carpetas que el agente no deba tocar nunca, como salidas de compilación.
+Denegar la lectura de una ruta también impide escribir en ella, y la regla vale para todos tus proyectos. Úsala para carpetas que el agente no deba tocar nunca, como salidas de compilación. Nunca se propone nada de `~/.gemini` ni de las extensiones de editor de Antigravity: Antigravity necesita esos ficheros para funcionar.
 
 ### 2. `.antigravityignore`
 

package/README.md

@@ -36,7 +36,7 @@ npx agy-insights
 npx agy-insights@latest --text
 ```
 
-`@latest` makes npx check for the newest version every time. Without it, a copy installed globally (`npm install -g`) or in the current project takes precedence and is never updated. To pin a version instead: `npx agy-insights@0.9.0`.
+`@latest` makes npx check for the newest version every time. Without it, a copy installed globally (`npm install -g`) or in the current project takes precedence and is never updated. To pin a version instead: `npx agy-insights@0.9.1`.
 
 **Globally:**
 
@@ -78,11 +78,11 @@ Analyzes your whole history (every conversation agy has kept, with no date limit
 The report gives two figures:
 
 - **Real usage**: the tokens Antigravity records in each conversation's log (`~/.gemini/antigravity-cli/brain/<id>/.system_generated/logs/transcript.jsonl`), subagents included. It is shown with and without cache, because it is unknown whether the quota counts cache the same way. This is the figure to compare between teammates.
-- **"~tokens"**: estimated from the stored size of each step. Useful to compare which files, folders or commands weigh the most, but they fall short of real usage, because every model call resends the accumulated context.
+- **"~tokens"**: estimated from the stored size of each step. Useful to compare which files, folders or commands weigh the most, but they fall short of real usage, because every model call resends the accumulated context. Images (screenshots, for example) are estimated by their size in pixels, as Gemini counts them (258 tokens per 768 px tile), not by their bytes.
 
 ## Reading the report
 
-At the top, the period selector and the totals. Then a chart of **token usage per day** (per week when the history spans more than ~4 months), to see how usage evolves. Switch it to **Per call** to see mean tokens per model call: the total follows how much you worked, while per call drops only when each call carries less context, so it is the one that shows whether a change paid off. Hover a column for its figures, or open "View as table". If you use both the CLI and the editor or the VS Code extension, **By origin** splits conversations and real tokens between them (the editor and the extension share their history, so they count together), and each session shows where it was held. Next, **Models and effort**: calls and real tokens per model and effort level (for example Gemini 3.8 Flash · High), including tokens per call, so you can see what a higher effort costs. Below, **What's happening** lists the findings; at the end, the details by project, file type, folder, file, tool and command. The project of each file is detected through its `.git` folder.
+At the top, the period selector and the totals. Then a chart of **token usage per day** (per week when the history spans more than ~4 months), to see how usage evolves. Switch it to **Per call** to see mean tokens per model call: the total follows how much you worked, while per call drops only when each call carries less context, so it is the one that shows whether a change paid off. Hover a column for its figures, or open "View as table". If you use both the CLI and the Antigravity IDE, app or an editor extension such as VS Code's, **By origin** splits conversations and real tokens between "CLI" and "IDE and extensions" (those share their history, so they count together), and each session shows where it was held. Next, **Models and effort**: calls and real tokens per model and effort level (for example Gemini 3.8 Flash · High), including tokens per call, so you can see what a higher effort costs. Below, **What's happening** lists the findings; at the end, the details by project, file type, folder, file, tool and command. The project of each file is detected through its `.git` folder.
 
 | Finding | What it means | What to do |
 |---|---|---|
@@ -98,7 +98,10 @@ Expand **How to exclude it** on a proposal. You'll see the exact file, where the
 
 ### 1. Deny reading it (Antigravity permission)
 
-This is the only thing that actually stops the agent from reading a path. It uses the [official permissions](https://antigravity.google/docs/permissions).
+This is the only thing that actually stops the agent from reading a path. It uses the [official permissions](https://antigravity.google/docs/permissions). Where the rule goes depends on which Antigravity read the file, and the report proposes the right place:
+
+- **IDE, app or editor extension** (such as VS Code's): they have no settings file to edit. Add the rule (`read_file(<path>)`) as a deny rule in their **Settings → Permission Grants**, for all projects or for one.
+- **CLI (`agy`)**:
 
 1. Open `~/.gemini/antigravity-cli/settings.json` (on Windows, `%USERPROFILE%\.gemini\antigravity-cli\settings.json`).
 2. Paste the rule inside `"permissions"` → `"deny"`. Create them if they don't exist; if they do, add the rule without removing anything:
@@ -116,7 +119,7 @@ This is the only thing that actually stops the agent from reading a path. It use
 
 3. Save and restart `agy`.
 
-Denying reads on a path also blocks writing to it, and the rule applies to all your projects. Use it for folders the agent should never touch, such as build output.
+Denying reads on a path also blocks writing to it, and the rule applies to all your projects. Use it for folders the agent should never touch, such as build output. Nothing under `~/.gemini` or Antigravity's editor extensions is ever proposed: Antigravity needs those files to work.
 
 ### 2. `.antigravityignore`
 

package/docs/how-it-works.md

@@ -102,5 +102,7 @@ node agy-insights.js --dir test/tmp/history
 ## To do
 
 - Confirm with `agy` that a `read_file` `deny` rule blocks the read.
+- Confirm that a deny rule added under Settings → Permission Grants blocks the read in the VS Code extension. Antigravity's own guide (`~/.gemini/antigravity/builtin/skills/antigravity_guide/references/app.md`) documents Permission Grants for the IDE and the app; `~/.gemini/antigravity/` has no `settings.json`, so `fixes.deny()` proposes the CLI's file only for paths the CLI read, and the Settings rule for paths the editor read (from each file's `origins`).
+- Image reads are estimated from the image's pixel size (`imageTokens()`: 258 tokens up to 384×384 px, else 258 per 768 px tile, as Gemini documents), read from the file's header; when the file can't be read, as 4 tiles.
 - Test with real histories from several developers (Windows and macOS).
 - Also read the history of the Antigravity app and IDE, if they use the same format.

package/lib/findings.js

@@ -55,15 +55,16 @@ function findings(r, opts = {}) {
     const byFolder = new Map();
     for (const x of nonSource) {
       const abs = x.abs.slice(0, x.abs.lastIndexOf('/'));
-      const e = byFolder.get(abs) || { abs, rel: x.rel.slice(0, x.rel.lastIndexOf('/')), root: x.root, project: x.project, kind: x.kind, tokens: 0, calls: 0 };
+      const e = byFolder.get(abs) || { abs, rel: x.rel.slice(0, x.rel.lastIndexOf('/')), root: x.root, project: x.project, kind: x.kind, tokens: 0, calls: 0, origins: [] };
       e.tokens += x.tokens;
       e.calls += x.calls;
+      for (const o of x.origins || []) if (!e.origins.includes(o)) e.origins.push(o);
       byFolder.set(abs, e);
     }
     const items = [...byFolder.values()].sort((a, b) => b.tokens - a.tokens).slice(0, 10).map((e) => ({
       label: `${where(e)}/`, tokens: e.tokens, detail: `${kindLabel(e.kind)} · ${f.reads(e.calls)}`,
       fixes: [
-        fixes.deny(e.abs),
+        ...fixes.deny(e.abs, e.origins),
         e.root && fixes.ignore(e.root, [`${e.rel}/`]),
         e.root && fixes.rule(e.root, f.ruleFolder(e.rel, kindLabel(e.kind))),
       ].filter(Boolean),
@@ -103,7 +104,7 @@ function findings(r, opts = {}) {
       // Exclusion is only offered for non-source files: denying core source code would break the agent's work.
       items: cross.slice(0, 10).map((x) => ({
         label: where(x), tokens: x.tokens, detail: `${f.sessions(x.convs)} · ${f.reads(x.calls)}`,
-        fixes: nonSourceKinds.has(x.kind) ? [fixes.deny(x.abs), x.root && fixes.ignore(x.root, [x.rel])].filter(Boolean) : [],
+        fixes: nonSourceKinds.has(x.kind) ? [...fixes.deny(x.abs, x.origins), x.root && fixes.ignore(x.root, [x.rel])].filter(Boolean) : [],
       })),
     });
   }

package/lib/fixes.js

@@ -4,6 +4,9 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { t } = require('./i18n');
+const { isAgentFile } = require('./history');
+
+const norm = (p) => p.replace(/[\\/]+/g, '/');
 
 const AGY_SETTINGS = path.join(os.homedir(), '.gemini', 'antigravity-cli', 'settings.json');
 
@@ -20,15 +23,33 @@ function deniedRules() {
 
 // Permission rule (https://antigravity.google/docs/permissions): deny > ask > allow, a denied read_file
 // path covers everything below it, and denying a read also denies writes there.
-function deny(absPath) {
+// The CLI reads its rules from ~/.gemini/antigravity-cli/settings.json. The IDE, the app and the editor
+// extensions have no such file: their rules are set in their Settings, under Permission Grants. So the
+// proposal follows `origins`, the Antigravity that read the path ('cli', 'editor'; null or none: the CLI's).
+// Antigravity's own files (~/.gemini, its extensions) are never proposed: it needs them to work.
+function deny(absPath, origins = ['cli']) {
+  if (isAgentFile(norm(absPath))) return [];
   const rule = `read_file(${native(absPath)})`;
-  return {
-    how: 'deny', title: t.fixes.denyTitle,
-    file: AGY_SETTINGS, where: t.fixes.denyWhere,
-    text: JSON.stringify(rule),
-    note: t.fixes.denyNote,
-    applied: deniedRules().includes(rule),
-  };
+  const out = [];
+  if (!origins.length || origins.some((o) => o !== 'editor')) {
+    out.push({
+      how: 'deny', title: t.fixes.denyTitle,
+      file: AGY_SETTINGS, where: t.fixes.denyWhere,
+      text: JSON.stringify(rule),
+      note: t.fixes.denyNote,
+      applied: deniedRules().includes(rule),
+    });
+  }
+  if (origins.includes('editor')) {
+    out.push({
+      how: 'deny-editor', title: t.fixes.denyEditorTitle,
+      file: t.fixes.denyEditorPlace, where: t.fixes.denyEditorWhere,
+      text: rule,
+      note: t.fixes.denyEditorNote,
+      applied: false,
+    });
+  }
+  return out;
 }
 
 // .antigravityignore: Antigravity's own exclusion file. Its scope is undocumented; it is confirmed to hide

package/lib/history.js

@@ -182,6 +182,57 @@ const key = (p) => norm(p).toLowerCase().replace(/\/+$/, '');
 // Kinds are stable ids; i18n.kindLabel() turns them into text.
 const NON_SOURCE = new Set(['node_modules', 'build', 'lockfiles', 'logs', 'generated']);
 
+// Antigravity's own files: ~/.gemini (CLI, editor, brain, skills) and its editor extensions.
+const isAgentFile = (p) => /(^|\/)\.gemini\//i.test(p) || /(^|\/)\.[\w-]+\/extensions\/[^/]*antigravity[^/]*\//i.test(p);
+
+// --- Images ---
+
+// The model gets images as pixels, not bytes: Gemini counts 258 tokens for an image up to 384×384 px, and
+// 258 per 768×768 tile above that. Their stored size / 4 would count a screenshot as ~100,000 tokens.
+const IMAGE_RE = /\.(png|jpe?g|gif|webp|bmp)$/i;
+const TILE_TOKENS = 258;
+const UNKNOWN_IMAGE_TOKENS = 4 * TILE_TOKENS; // a typical screenshot, when the file can't be read
+
+// Width and height from the file's header (PNG, GIF, BMP, WebP, JPEG), or null.
+function imageSize(file) {
+  let b;
+  try {
+    const fd = fs.openSync(file, 'r');
+    b = Buffer.alloc(64 * 1024);
+    b = b.subarray(0, fs.readSync(fd, b, 0, b.length, 0));
+    fs.closeSync(fd);
+  } catch { return null; }
+  if (b.length >= 24 && b.readUInt32BE(0) === 0x89504e47) return [b.readUInt32BE(16), b.readUInt32BE(20)];
+  if (b.length >= 10 && b.toString('latin1', 0, 3) === 'GIF') return [b.readUInt16LE(6), b.readUInt16LE(8)];
+  if (b.length >= 26 && b.toString('latin1', 0, 2) === 'BM') return [b.readInt32LE(18), Math.abs(b.readInt32LE(22))];
+  if (b.length >= 30 && b.toString('latin1', 0, 4) === 'RIFF' && b.toString('latin1', 8, 12) === 'WEBP') {
+    const f = b.toString('latin1', 12, 16);
+    if (f === 'VP8X') return [1 + b.readUIntLE(24, 3), 1 + b.readUIntLE(27, 3)];
+    if (f === 'VP8 ') return [b.readUInt16LE(26) & 0x3fff, b.readUInt16LE(28) & 0x3fff];
+    if (f === 'VP8L') { const v = b.readUInt32LE(21); return [1 + (v & 0x3fff), 1 + ((v >> 14) & 0x3fff)]; }
+  }
+  if (b[0] === 0xff && b[1] === 0xd8) {
+    for (let i = 2; i + 9 < b.length;) {
+      if (b[i] !== 0xff) { i++; continue; }
+      const m = b[i + 1];
+      if (m >= 0xc0 && m <= 0xcf && ![0xc4, 0xc8, 0xcc].includes(m)) return [b.readUInt16BE(i + 7), b.readUInt16BE(i + 5)];
+      i += 2 + b.readUInt16BE(i + 2);
+    }
+  }
+  return null;
+}
+
+const imageCache = new Map();
+function imageTokens(file) {
+  if (!imageCache.has(file)) {
+    const size = imageSize(file);
+    const [w, h] = size && size[0] > 0 && size[1] > 0 ? size : [0, 0];
+    imageCache.set(file, !w ? UNKNOWN_IMAGE_TOKENS
+      : w <= 384 && h <= 384 ? TILE_TOKENS : Math.ceil(w / 768) * Math.ceil(h / 768) * TILE_TOKENS);
+  }
+  return imageCache.get(file);
+}
+
 /**
  * @param {string} p path with "/" separators
  * @param {object} [opts]
@@ -190,12 +241,14 @@ const NON_SOURCE = new Set(['node_modules', 'build', 'lockfiles', 'logs', 'gener
  */
 function kind(p, { inRepo = false } = {}) {
   // Antigravity's own data (the agent's brain: plans, artifacts, logs; and skills): it needs them, so they
-  // are never reported as generated or proposed for exclusion, whatever their names look like.
-  if (/(^|\/)\.gemini\//i.test(p)) return 'agent';
+  // are never reported as generated or proposed for exclusion, whatever their names look like. The same for
+  // the Antigravity extension installed in an editor (~/.vscode/extensions/google.google-antigravity-…).
+  if (isAgentFile(p)) return 'agent';
   if (/(^|\/)node_modules\//.test(p)) return 'node_modules';
   if (!inRepo && /(^|\/)(dist|build|out|target|coverage|allure-results|allure-report|\.next|bin|obj)\//i.test(p)) return 'build';
   if (/(package-lock\.json|yarn\.lock|pnpm-lock\.yaml|packages\.lock\.json|\.lock)$/.test(p)) return 'lockfiles';
   if (/\.(log|map)$|\.min\.(js|css)$/.test(p)) return 'logs';
+  if (IMAGE_RE.test(p)) return 'images';
   if (/(^|\/)(tests?|__tests__|specs?)\//i.test(p) || /\.(test|spec|tests?)\.\w+$/i.test(p) || /Tests?\//.test(p)) return 'tests';
   if (/\.designer\.cs$|\.g\.cs$|\.generated\.\w+$|(^|\/)(generated|Migrations)\//i.test(p)) return 'generated';
   const ext = path.extname(p).toLowerCase();
@@ -345,11 +398,13 @@ async function conversationTitles(dir, tmp) {
 
 class Counter {
   constructor() { this.m = new Map(); }
-  // Numeric fields are summed; `meta` is stored the first time a key is seen.
-  add(k, fields, meta = {}) {
+  // Numeric fields are summed; `meta` is stored the first time a key is seen, except `origin`, which is
+  // collected into `origins` (every origin that touched the key).
+  add(k, fields, { origin, ...meta } = {}) {
     let e = this.m.get(k);
     if (!e) this.m.set(k, (e = { key: k, calls: 0, tokens: 0, rereads: 0, rereadTokens: 0, convs: 0, ...meta }));
     for (const [f, v] of Object.entries(fields)) e[f] = (e[f] || 0) + v;
+    if (origin !== undefined && !(e.origins ||= []).includes(origin)) e.origins.push(origin);
   }
   all() { return [...this.m.values()].sort((a, b) => b.tokens - a.tokens || b.calls - a.calls); }
 }
@@ -367,7 +422,8 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
   const dir = (dirs.filter((d) => fs.existsSync(d)).length ? dirs.filter((d) => fs.existsSync(d)) : dirs).join(' + ');
   const custom = Object.entries(customKinds).map(([re, label]) => [new RegExp(re, 'i'), label]);
   // A file git keeps in the repo is never build output, whatever its folder is called.
-  const classify = (p, root, rel) => custom.find(([re]) => re.test(p))?.[1]
+  // Antigravity's own files stay 'agent' even when a custom type matches them: they must never be excluded.
+  const classify = (p, root, rel) => (isAgentFile(p) ? 'agent' : custom.find(([re]) => re.test(p))?.[1])
     || kind(p, { inRepo: Boolean(root && repoFiles(root)?.has(rel.toLowerCase())) });
   const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'agy-insights-'));
   const r = {
@@ -392,6 +448,7 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
       // When it happened: the transcript's step times, else the database's last write.
       const id = f.replace(/\.db$/, '');
       const log = realUsage(dir, id);
+      const origin = originOf(dir);
       const end = log?.end ?? fs.statSync(path.join(dir, f)).mtimeMs;
       const start = log?.start ?? end;
       // Real usage from the log when it has token counts; else from gen_metadata (below), else the estimate.
@@ -419,8 +476,16 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
           convBytes += bytes;
           // The step payload also carries the tool result: its size approximates what entered the context.
           toolCalls(strs).forEach((c, i) => {
+            const fk = FILE_KEYS.find((k) => typeof c.args[k] === 'string');
+            const read = fk && /^(view_file|read_)/.test(c.name) ? norm(c.args[fk]) : null;
             // A call is counted once (first time its id shows up); every step that carries it adds its size.
-            const tokens = i === 0 ? bytes / BYTES_PER_TOKEN : 0;
+            // An image read counts what the model gets from its pixels, not the bytes stored in the step.
+            let tokens = i === 0 ? bytes / BYTES_PER_TOKEN : 0;
+            if (tokens && read && IMAGE_RE.test(read)) {
+              const image = Math.min(tokens, imageTokens(read));
+              convBytes -= (tokens - image) * BYTES_PER_TOKEN;
+              tokens = image;
+            }
             const isNew = !seenCalls.has(c.id);
             if (isNew) seenCalls.set(c.id, 0);
             const calls = isNew ? 1 : 0;
@@ -429,10 +494,9 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
             if (c.name === 'run_command' && typeof c.args.CommandLine === 'string') {
               commands.add(c.args.CommandLine.trim().split(/\s+/).slice(0, 2).join(' '), { calls, tokens });
             }
-            const fk = FILE_KEYS.find((k) => typeof c.args[k] === 'string');
-            if (!fk || !/^(view_file|read_)/.test(c.name)) return;
+            if (!read) return;
 
-            const file = norm(c.args[fk]);
+            const file = read;
             const { StartLine: s, EndLine: e } = c.args;
             if (isNew) {
               const range = `${key(file)}|${s}-${e}`;
@@ -451,8 +515,9 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
             const fields = { calls, tokens, rereads: isNew ? reread : 0, rereadTokens: reread * tokens };
             kinds.add(k, { ...fields, convs: once(seenKinds, k) }, { nonSource: NON_SOURCE.has(k) });
             projects.add(root || '', { ...fields, convs: once(seenProjects, root || '') }, { project });
-            folders.add(key(folderAbs), { ...fields, convs: once(seenFolders, key(folderAbs)) }, { abs: folderAbs, rel: folderRel, root, project });
-            files.add(key(file), { ...fields, convs: once(seenFiles, key(file)) }, { abs: file, rel, root, project, kind: k });
+            // `origin`: which Antigravity read it (CLI or editor), so exclusions point to the right settings.
+            folders.add(key(folderAbs), { ...fields, convs: once(seenFolders, key(folderAbs)) }, { abs: folderAbs, rel: folderRel, root, project, origin });
+            files.add(key(file), { ...fields, convs: once(seenFiles, key(file)) }, { abs: file, rel, root, project, kind: k, origin });
           });
         }
         const metaBlobs = db.all('select data from gen_metadata order by idx').map(([blob]) => blob);
@@ -498,7 +563,7 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
         const main = [...counts].sort((a, b) => b[1] - a[1])[0];
         const model = main ? models.get(main[0]) : null;
         r.sessions.push({
-          id, title: titles.get(id) || null, origin: originOf(dir), start, end, steps: steps.length, tokens: convBytes / BYTES_PER_TOKEN, usage,
+          id, title: titles.get(id) || null, origin, start, end, steps: steps.length, tokens: convBytes / BYTES_PER_TOKEN, usage,
           model: model ? { model: model.model, effort: model.effort } : null, models: counts.size,
           // For --debug-models: where each call's model came from, and for rows where no model was recognized,
           // the short strings that look like a model id (to spot a new format). Never prompts, paths or code.
@@ -538,4 +603,4 @@ async function analyze({ dir: dirs = DEFAULT_DIRS, workspaces = [], customKinds
   };
 }
 
-module.exports = { analyze, DEFAULT_DIR, DEFAULT_DIRS, kind, NON_SOURCE, realUsage, dayKey, modelOf, selectedModel, repoFiles };
+module.exports = { analyze, DEFAULT_DIR, DEFAULT_DIRS, kind, isAgentFile, imageTokens, NON_SOURCE, realUsage, dayKey, modelOf, selectedModel, repoFiles };

package/lib/i18n.js

@@ -43,14 +43,18 @@ Options:
 
   kinds: {
     agent: "Antigravity's own files (brain, skills)",
-    build: 'build output (dist, bin, obj…)', logs: 'logs, maps, minified', generated: 'generated code / migrations',
+    build: 'build output (dist, bin, obj…)', logs: 'logs, maps, minified', generated: 'generated code / migrations', images: 'images',
     other: 'other', code: (ext) => `code ${ext}`,
   },
 
   fixes: {
-    denyTitle: 'Deny reading it (Antigravity permission)',
+    denyTitle: 'Deny reading it in the CLI (Antigravity permission)',
     denyWhere: 'inside "permissions" → "deny"',
     denyNote: 'This is the only thing that actually blocks the read. It applies to all your projects, also blocks writing to that path, and agy must be restarted.',
+    denyEditorTitle: 'Deny reading it in the IDE and extensions (Antigravity permission)',
+    denyEditorPlace: 'Settings → Permission Grants',
+    denyEditorWhere: 'of the Antigravity IDE, app or editor extension, as a deny rule',
+    denyEditorNote: 'These have no settings file to edit: rules are added from their Settings. It blocks the read in all your projects (or only in one, as a project-level grant) and also blocks writing to that path.',
     ignoreTitle: 'Add to .antigravityignore',
     ignoreWhere: 'at the end of the file (create it if missing)',
     ignoreNote: 'Hides it from @ completion; it is not documented to stop the agent from reading it.',
@@ -122,9 +126,9 @@ Options:
     efforts: { minimal: 'Minimal', low: 'Low', medium: 'Medium', high: 'High', xhigh: 'Extra high', 'extra high': 'Extra high', max: 'Max' },
     sessionsTitle: 'Sessions (real usage)',
     sessionCols: ['Conversation', 'When', 'Origin', 'Model', 'Tokens', '%', 'With cache', 'Calls', 'Errors'],
-    origin: { cli: 'CLI', editor: 'Editor / VS Code', other: 'Other folder' },
+    origin: { cli: 'CLI', editor: 'IDE and extensions', other: 'Other folder' },
     originsTitle: 'By origin',
-    originsHint: 'Where each conversation was held. The editor and the VS Code extension keep the same history, so they are counted together.',
+    originsHint: 'Where each conversation was held. The Antigravity IDE, the Antigravity app and the editor extensions (such as the VS Code one) keep the same history, so they are counted together.',
     originCols: ['Origin', 'Conversations', 'Calls', 'Tokens', '%', 'Per call', 'With cache'],
     originsText: '  By origin:',
     noConversations: (scope, dir) => `No conversations${scope ? ` for <code>${scope}</code>` : ''} in <code>${dir}</code>.`,
@@ -224,14 +228,18 @@ Opciones:
 
   kinds: {
     agent: 'ficheros propios de Antigravity (brain, skills)',
-    build: 'build output (dist, bin, obj…)', logs: 'logs, maps, minificados', generated: 'código generado / migraciones',
+    build: 'build output (dist, bin, obj…)', logs: 'logs, maps, minificados', generated: 'código generado / migraciones', images: 'imágenes',
     other: 'otros', code: (ext) => `código ${ext}`,
   },
 
   fixes: {
-    denyTitle: 'Denegar la lectura (permiso de Antigravity)',
+    denyTitle: 'Denegar la lectura en el CLI (permiso de Antigravity)',
     denyWhere: 'dentro de "permissions" → "deny"',
     denyNote: 'Es lo único que impide la lectura. Afecta a todos tus proyectos, también impide escribir en esa ruta, y hay que reiniciar agy.',
+    denyEditorTitle: 'Denegar la lectura en el IDE y extensiones (permiso de Antigravity)',
+    denyEditorPlace: 'Settings → Permission Grants',
+    denyEditorWhere: 'del IDE, la app o la extensión de Antigravity, como regla de denegación',
+    denyEditorNote: 'No tienen un fichero de ajustes que editar: la regla se añade desde sus Settings. Impide la lectura en todos tus proyectos (o solo en uno, como permiso del proyecto) y también impide escribir en esa ruta.',
     ignoreTitle: 'Añadir a .antigravityignore',
     ignoreWhere: 'al final del fichero (créalo si no existe)',
     ignoreNote: 'Lo oculta del autocompletado con @; no está documentado que impida leerlo.',
@@ -303,9 +311,9 @@ Opciones:
     efforts: { minimal: 'Mínimo', low: 'Bajo', medium: 'Medio', high: 'Alto', xhigh: 'Muy alto', 'extra high': 'Muy alto', max: 'Máximo' },
     sessionsTitle: 'Sesiones (consumo real)',
     sessionCols: ['Conversación', 'Cuándo', 'Origen', 'Modelo', 'Tokens', '%', 'Con caché', 'Llamadas', 'Errores'],
-    origin: { cli: 'CLI', editor: 'Editor / VS Code', other: 'Otra carpeta' },
+    origin: { cli: 'CLI', editor: 'IDE y extensiones', other: 'Otra carpeta' },
     originsTitle: 'Por origen',
-    originsHint: 'Desde dónde se tuvo cada conversación. El editor y la extensión de VS Code guardan el mismo historial, así que se cuentan juntos.',
+    originsHint: 'Desde dónde se tuvo cada conversación. El IDE de Antigravity, la app de Antigravity y las extensiones de editor (como la de VS Code) guardan el mismo historial, así que se cuentan juntos.',
     originCols: ['Origen', 'Conversaciones', 'Llamadas', 'Tokens', '%', 'Por llamada', 'Con caché'],
     originsText: '  Por origen:',
     noConversations: (scope, dir) => `No hay conversaciones${scope ? ` de <code>${scope}</code>` : ''} en <code>${dir}</code>.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agy-insights",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Measures Antigravity token usage (CLI, editor and VS Code extension) and shows which context is sent repeatedly or needlessly, in English or Spanish. Run: npx agy-insights@latest",
   "license": "MIT",
   "keywords": [