@nanonets/graft 0.24.1 → 0.25.0

package/dist/claude/tally.js

@@ -16,18 +16,14 @@
  * it is stored or sent; the session keeps a count and the telemetry contract
  * carries that count as a bucket. See TELEMETRY.md.
  *
- * Only the tail is read. A transcript grows for the life of a session and can
- * reach many megabytes, while the answer is always in its last few entries — a
- * hook that read the whole file would get slower every turn for no extra signal.
+ * Only what the transcript gained since the last Stop is read (a transcript
+ * grows for the life of a session; a real one passed 233 MB), through the
+ * trace layer's cursor, and what has to outlive one read (the reply in
+ * progress, the responses already billed) rides in that cursor's memo.
  */
-import { closeSync, fstatSync, openSync, readSync } from 'node:fs';
+import { readNewEvents, isTypedByPerson, textOf } from '../trace/claude.js';
+import { readJson } from '../util/state.js';
 import { turnInputCostMicros, turnInputTokens } from '../context/price.js';
-/**
- * How much of the transcript's end to read. Comfortably larger than any single
- * turn's worth of entries, small enough that the read cost is flat as the
- * session grows.
- */
-const TAIL_BYTES = 1024 * 1024;
 /**
  * The tally, as the agent is actually asked to write it: a "graft saved ~N
  * tokens" claim in prose. Deliberately loose about the decoration around it —
@@ -42,170 +38,120 @@ const TALLY = /(?:graft|trail)\s+saved\s*[~≈]?\s*[\d,.]+\s*[km]?\s*(?:tok|toke
 export function hasSavingsTally(text) {
     return TALLY.test(text);
 }
-/** Read the last {@link TAIL_BYTES} of a file as utf8, dropping the leading
- * partial line a byte-offset read leaves behind. Returns '' on any I/O trouble —
- * a hook never fails over a metric. */
-function readTail(path) {
-    let fd;
-    try {
-        fd = openSync(path, 'r');
-        const size = fstatSync(fd).size;
-        const len = Math.min(size, TAIL_BYTES);
-        const buf = Buffer.allocUnsafe(len);
-        readSync(fd, buf, 0, len, size - len);
-        const raw = buf.toString('utf8');
-        return len < size ? raw.slice(raw.indexOf('\n') + 1) : raw;
-    }
-    catch {
-        return '';
-    }
-    finally {
-        if (fd !== undefined) {
-            try {
-                closeSync(fd);
-            }
-            catch { /* already gone */ }
-        }
-    }
+/** Responses remembered as billed: one response's lines sit together, so a short list is enough. */
+const BILLED_KEPT = 64;
+/** The memo saved with the cursor, when it has the hooks' key. */
+function savedHooks(memo) {
+    const h = memo && typeof memo === 'object' ? memo.hooks : undefined;
+    return h && typeof h === 'object' && h.turn && Array.isArray(h.billed) ? h : null;
 }
-/** Is this entry a user's own prompt, rather than a tool result wearing the
- * `user` role? Tool results carry a `tool_result` part; a real prompt does not.
- * The boundary matters because the tally can land in any text block of the turn,
- * not only the last one. */
-function isUserPrompt(entry) {
-    if (entry?.type !== 'user' || entry?.isMeta)
-        return false;
-    const content = entry?.message?.content;
-    if (typeof content === 'string')
-        return true;
-    return Array.isArray(content) && !content.some((p) => p?.type === 'tool_result');
+/** A usage count as a bill can take it: a finite number of tokens, never below zero. */
+function count(v) {
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n : 0;
 }
-function textOf(content) {
-    if (typeof content === 'string')
-        return content;
-    if (!Array.isArray(content))
-        return '';
-    return content.map((p) => (p?.type === 'text' ? String(p.text ?? '') : '')).join('\n');
-}
-/**
- * The assistant prose of the turn the transcript ends on, or null when it can't
- * be read (no path — a host whose Stop hook doesn't name one — unreadable file,
- * or a tail with no assistant text in it).
- *
- * Null is meaningfully different from "no tally found": a turn we cannot observe
- * is left out of BOTH the numerator and the denominator by the caller, so a host
- * that exposes no transcript reports no ratio rather than a ratio of zero.
- *
- * Sidechain entries (subagents) are skipped throughout — a subagent's own prose
- * is never what the user read.
- */
-export function lastAssistantTurn(transcriptPath) {
-    if (typeof transcriptPath !== 'string' || !transcriptPath)
-        return null;
-    const tail = readTail(transcriptPath);
-    if (!tail)
-        return null;
-    const entries = [];
-    for (const line of tail.split('\n')) {
-        if (!line.trim())
-            continue;
-        try {
-            entries.push(JSON.parse(line));
+/** Fold one transcript line into the memo and this read's bill. */
+function fold(e, m, bill) {
+    // Subagent lines are another context's work: never what the user read, never this session's bill.
+    if (e.isSidechain)
+        return;
+    // The person's own prompt starts a new reply. A task notice, a command
+    // wrapper, a compaction summary or a hand-back does not.
+    if (e.type === 'user') {
+        if (isTypedByPerson(e)) {
+            m.turn = { uuid: null, tally: false };
+            if (bill.open)
+                bill.open = { costMicros: 0, tokens: 0 };
         }
-        catch { /* clipped or partial line */ }
+        return;
     }
-    // Walk back to the turn boundary, collecting assistant text on the way.
-    const parts = [];
-    let uuid = null;
-    for (let i = entries.length - 1; i >= 0; i--) {
-        const e = entries[i];
-        if (e?.isSidechain)
-            continue;
-        if (isUserPrompt(e))
-            break;
-        if (e?.type !== 'assistant')
-            continue;
-        const text = textOf(e?.message?.content);
-        if (!text.trim())
-            continue;
-        if (uuid === null && typeof e?.uuid === 'string')
-            uuid = e.uuid;
-        parts.unshift(text);
+    if (e.type !== 'assistant' || e.isApiErrorMessage)
+        return;
+    if (typeof e.uuid === 'string')
+        bill.out.lastUuid = e.uuid;
+    const msg = e.message;
+    const text = textOf(msg?.content);
+    if (text.trim()) {
+        if (typeof e.uuid === 'string')
+            m.turn.uuid = e.uuid;
+        if (hasSavingsTally(text))
+            m.turn.tally = true;
     }
-    if (uuid === null || parts.length === 0)
-        return null;
-    return { uuid, text: parts.join('\n') };
+    billResponse(msg, m, bill);
+    // Everything up to here was billed before.
+    if (bill.open && bill.billedThrough && e.uuid === bill.billedThrough)
+        bill.open = { costMicros: 0, tokens: 0 };
+}
+/** Bill one response's input once, by `message.id`: its lines (thinking, text, tool_use) each repeat the same `usage`. */
+function billResponse(msg, m, bill) {
+    const id = msg?.id;
+    const usage = msg?.usage;
+    if (typeof id !== 'string' || !usage || m.billed.includes(id))
+        return;
+    m.billed.push(id);
+    if (m.billed.length > BILLED_KEPT)
+        m.billed.splice(0, m.billed.length - BILLED_KEPT);
+    const turn = {
+        model: String(msg?.model ?? ''),
+        input: count(usage.input_tokens),
+        cacheCreate: count(usage.cache_creation_input_tokens),
+        cacheRead: count(usage.cache_read_input_tokens),
+    };
+    const micros = turnInputCostMicros(turn);
+    // An unpriced model contributes neither cost nor tokens: leaving its tokens
+    // in the denominator alone would drag the blended rate toward zero and
+    // quietly under-report every saving after it.
+    if (micros === null || !Number.isFinite(micros))
+        return;
+    const sink = bill.open ?? bill.out;
+    sink.costMicros += micros;
+    sink.tokens += turnInputTokens(turn);
 }
 /**
- * What the turn the transcript ends on cost in input tokens — the measured
- * half of the dollar figure the statusline and the turn nudge report.
- *
- * Costed per API response, not per turn, so a turn that switched models is
- * priced correctly rather than labelled with whichever model happened to go
- * last. Responses are deduped by `message.id`: one response is written to the
- * transcript as several entries (a `thinking` block and a `tool_use` block land
- * on their own lines) and every one of them repeats the same `usage`, so
- * summing the lines would bill the turn two or three times over.
- *
- * Null when there is nothing to bill — no transcript path (a host whose Stop
- * hook names none), an unreadable file, a turn whose entries carry no `usage`,
- * or a model with no price in {@link inputUsdPerMtok}. As everywhere in this
- * file, null means "not observed", never "zero".
+ * What a Claude Code transcript gained since the last read with the same
+ * cursor: the cost of each response seen for the first time, and the reply in
+ * progress. The first read of a session takes at most the transcript's last
+ * 8 MB and bills only the reply in progress (see {@link Bill});
+ * `billedThrough` is the last reply billed before (kept with the totals, so
+ * it outlives a lost cursor). `also` sees each line of the same read, with
+ * the same memo, for another turn-end reader (the learning ask) that keeps
+ * its state under a key of its own. Never throws; an unreadable file reads
+ * as nothing new.
  */
-export function lastTurnBilling(transcriptPath) {
-    if (typeof transcriptPath !== 'string' || !transcriptPath)
-        return null;
-    const tail = readTail(transcriptPath);
-    if (!tail)
-        return null;
-    const entries = [];
-    for (const line of tail.split('\n')) {
-        if (!line.trim())
-            continue;
-        try {
-            entries.push(JSON.parse(line));
-        }
-        catch { /* clipped or partial line */ }
+export function catchUpTranscript(transcriptPath, cursorPath, opts = {}) {
+    const out = { fresh: false, costMicros: 0, tokens: 0, turn: { uuid: null, tally: false }, lastUuid: null };
+    const bill = { out, open: null, billedThrough: opts.billedThrough };
+    // What the last read billed, kept apart: a read that starts over gets an empty memo.
+    let before = [];
+    try {
+        before = savedHooks((readJson(cursorPath))?.trace?.memo)?.billed.filter((id) => typeof id === 'string') ?? [];
+    }
+    catch {
+        // No cursor yet, or one that can't be read: nothing to carry.
     }
-    const seen = new Set();
-    let uuid = null;
-    let costMicros = 0;
-    let tokens = 0;
-    for (let i = entries.length - 1; i >= 0; i--) {
-        const e = entries[i];
-        if (e?.isSidechain)
-            continue;
-        if (isUserPrompt(e))
-            break;
-        if (e?.type !== 'assistant')
-            continue;
-        if (uuid === null && typeof e?.uuid === 'string')
-            uuid = e.uuid;
-        const msg = e?.message;
-        const id = msg?.id;
-        if (typeof id !== 'string' || seen.has(id))
-            continue;
-        const usage = msg?.usage;
-        if (!usage)
-            continue;
-        seen.add(id);
-        const turn = {
-            model: String(msg?.model ?? ''),
-            input: Number(usage.input_tokens) || 0,
-            cacheCreate: Number(usage.cache_creation_input_tokens) || 0,
-            cacheRead: Number(usage.cache_read_input_tokens) || 0,
-        };
-        const micros = turnInputCostMicros(turn);
-        // An unpriced model contributes neither cost nor tokens: leaving its tokens
-        // in the denominator alone would drag the blended rate toward zero and
-        // quietly under-report every saving after it.
-        if (micros === null)
-            continue;
-        costMicros += micros;
-        tokens += turnInputTokens(turn);
+    readNewEvents(transcriptPath, cursorPath, {
+        onEntry: (entry, memo) => {
+            try {
+                let m = savedHooks(memo);
+                if (!m) {
+                    m = { turn: { uuid: null, tally: false }, billed: before.slice(-BILLED_KEPT) };
+                    memo.hooks = m;
+                    bill.open = { costMicros: 0, tokens: 0 };
+                }
+                fold(entry, m, bill);
+                opts.also?.(entry, memo);
+                out.fresh = true;
+                out.turn = m.turn;
+            }
+            catch {
+                // One odd line costs that line, never the read.
+            }
+        },
+    });
+    if (bill.open) {
+        out.costMicros += bill.open.costMicros;
+        out.tokens += bill.open.tokens;
     }
-    if (uuid === null || tokens === 0)
-        return null;
-    return { uuid, costMicros, tokens };
+    return out;
 }
 //# sourceMappingURL=tally.js.map

package/dist/claude/tally.js.map

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

package/dist/claude/walls-hook.d.ts

@@ -0,0 +1,52 @@
+import type { RunCall, RunState, SkillSessionState, WallClass } from '../trace/types.js';
+import type { GateCtx } from '../trace/skill-session.js';
+import { type WallCtx } from '../trace/walls.js';
+import type { Sent } from './skills-hook-util.js';
+/** How long after a deny a passing call of the same command counts as the deny avoided (3.5 step 5). */
+export declare const AVOIDED_MS: number;
+/** At most this many wall fixes after a compaction (3.1 step 9, R38). */
+export declare const COMPACT_FIXES = 2;
+/**
+ * An executable `program` in the hook's PATH or 4.11's fixed folders (the hook's PATH can be narrower than the shell's).
+ * On Windows PATH splits on ';', the program is git.exe or npm.cmd (PATHEXT), and any regular file counts: there is no exec bit.
+ */
+export declare function onPathHere(program: string, env: NodeJS.ProcessEnv): boolean;
+/** The facts a fix line may use: which programs are here, and origin's SSH address when it is https (checked by sshRemoteFor). */
+export declare function wallCtxFor(checkout: string, env: NodeJS.ProcessEnv): WallCtx;
+/**
+ * 3.4 step 1: the fix line for `cls`, then "what fixed this here before" when a kept lesson for the wall applies
+ * here and worked in 2 or more epochs (4.10). `hadLesson`: a live lesson for this wall applies here.
+ */
+export declare function wallContextText(cls: WallClass, place: {
+    checkout: string;
+    repoKey: string;
+    env: NodeJS.ProcessEnv;
+    now: Date;
+}): {
+    text: string;
+    hadLesson: boolean;
+};
+/** 3.4 step 1 on a hook payload: the class the result hits, or null. Exit 0 under P23's limits (matchWall's own). */
+export declare function wallOfResult(result: string, command: string, failed: boolean): WallClass | null;
+/** A run's wall hits that count: not a flake retried as is, not a dropped tail (b2: `ignoredFailure(call, next)`). */
+export declare function countedHits(run: RunState): RunCall[];
+/** `timeout [-s SIG] [-k 5] [--foreground] 60 npm test` without its timeout part: `npm test`; null when there is none. */
+export declare function withoutTimeout(cmd: string | null): string | null;
+/**
+ * 3.5 steps 1 and 2 (`learn`): this session's wall hits (`seen`), repairs (`fixed`, an open run's read from its calls
+ * now) and the kept lessons that worked again, in one locked write of walls.json, only when something is new.
+ * Phase 2 (D129): returns how many new wall hits this Stop recorded whose fix reached the model: a failed call's where
+ * the host reads PostToolUseFailure's context (Codex has none), any other's where it reads PostToolUse's.
+ */
+export declare function wallsAtStop(st: SkillSessionState, ctx: GateCtx): number;
+/**
+ * 3.5 step 5 (`fold`): one `guardrail{sure-fail}` per deny the fast path marked since the last Stop, and
+ * `guardrail{avoided}` for each whose command, without timeout, then passed within 30 minutes. Moves `deniedSeen` on.
+ */
+export declare function guardrailCounts(st: SkillSessionState, ctx: GateCtx, sent: Sent): void;
+/**
+ * 3.1 step 9 (R38): the fix lines for the walls hit in the epoch a compaction just closed, at most 2, read from the
+ * calls still held and from walls.json's hits for this session and epoch.
+ */
+export declare function compactWallLines(st: SkillSessionState, ctx: GateCtx): string[];
+//# sourceMappingURL=walls-hook.d.ts.map

package/dist/claude/walls-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walls-hook.d.ts","sourceRoot":"","sources":["../../src/claude/walls-hook.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAsD,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUrG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIlD,wGAAwG;AACxG,eAAO,MAAM,UAAU,QAAiB,CAAC;AACzC,yEAAyE;AACzE,eAAO,MAAM,aAAa,IAAI,CAAC;AAG/B;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAuB3E;AAED,kIAAkI;AAClI,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAW5E;AAOD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAarK;AAED,qHAAqH;AACrH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAE/F;AAKD,sHAAsH;AACtH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,EAAE,CAGpD;AAED,0HAA0H;AAC1H,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAGhE;AASD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAuDvE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAyBrF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAa9E"}