harnery 0.35.0 → 0.37.0

package/dist/core/hooks/adapter/runtime-telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-telemetry.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/runtime-telemetry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-telemetry.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/runtime-telemetry.ts"],"names":[],"mappings":"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"}

package/dist/core/hooks/adapter/runtime-telemetry.js

@@ -4,9 +4,17 @@ import { homedir } from "node:os";
 import { basename, join, resolve } from "node:path";
 import { transcriptPathCandidates } from "../resolve/transcript.js";
 const DEFAULT_TAIL_BYTES = 256 * 1024;
+/**
+ * An active turn can accumulate enough tool traffic to push its native turn
+ * ancestor beyond the ordinary status tail. Keep attribution bounded while
+ * giving long-running interactive turns a larger matching window.
+ */
+const ACTIVE_TURN_TAIL_BYTES = 4 * 1024 * 1024;
 const DEFAULT_MAX_SAMPLE_AGE_MS = 30_000;
+const DEFAULT_MAX_CURSOR_DATABASES = 8;
 const SESSION_CACHE_LIMIT = 128;
 const codexTranscriptCache = new Map();
+const cursorDatabaseCache = new Map();
 /**
  * Read privacy-safe context telemetry from a local runtime transcript.
  *
@@ -18,13 +26,15 @@ export function readRuntimeContextTelemetry(request, options = {}) {
     const startedAt = performance.now();
     if (!request.session_id)
         return unsupported("runtime_session_id_not_reported", startedAt);
-    if (request.mode === "turn" && !request.turn_id) {
+    if (request.mode !== "status" && !request.turn_id && request.adapter !== "cursor") {
         return unsupported("runtime_turn_id_not_reported", startedAt);
     }
     if (request.adapter === "codex")
         return readCodexContext(request, options, startedAt);
     if (request.adapter === "claude-code")
         return readClaudeContext(request, options, startedAt);
+    if (request.adapter === "cursor")
+        return readCursorContext(request, options, startedAt);
     return unsupported("runtime_adapter_not_supported", startedAt);
 }
 /**
@@ -48,12 +58,13 @@ export function discoverCodexSessionTranscript(sessionId, transcriptPath, option
 /** Status compatibility wrapper: exact pairs render; partial values do not. */
 export function readRuntimeContextUsage(adapter, sessionId, options = {}) {
     const result = readRuntimeContextTelemetry({ adapter, session_id: sessionId, mode: "status" }, options);
-    return result.state === "observed"
+    return result.state === "observed" && "used_tokens" in result
         ? { used: result.used_tokens, window: result.limit_tokens }
         : null;
 }
 export function clearRuntimeTelemetryCachesForTest() {
     codexTranscriptCache.clear();
+    cursorDatabaseCache.clear();
 }
 /**
  * Read the newest observed tuning (effort, and speed where reported) for a
@@ -233,7 +244,8 @@ function readCodexContext(request, options, startedAt) {
     if (resolved.state === "mismatch") {
         return partial("codex_transcript_session_mismatch", 0, startedAt);
     }
-    const tail = readTail(resolved.path, options.maxTailBytes ?? DEFAULT_TAIL_BYTES);
+    const tail = readTail(resolved.path, options.maxTailBytes ??
+        (request.mode === "active_turn" ? ACTIVE_TURN_TAIL_BYTES : DEFAULT_TAIL_BYTES));
     if (!tail)
         return partial("codex_transcript_unreadable", 0, startedAt);
     const rows = parseRuntimeRows(tail.text);
@@ -241,6 +253,14 @@ function readCodexContext(request, options, startedAt) {
         const token = newestCodexToken(rows);
         return codexObservation(request, token, undefined, tail.bytes, options, startedAt);
     }
+    if (request.mode === "active_turn") {
+        const active = tokenWithinActiveTurn(rows, request.turn_id);
+        const token = active.state === "found" ? active.token : tokenAtOrAfter(rows, request.turn_started_at);
+        if (active.state === "turn_missing" && !token) {
+            return partial("codex_transcript_turn_not_found", tail.bytes, startedAt);
+        }
+        return codexObservation(request, token, undefined, tail.bytes, options, startedAt);
+    }
     const turnId = request.turn_id;
     const terminalIndex = findCodexTurnTerminal(rows, turnId);
     if (terminalIndex < 0) {
@@ -274,6 +294,14 @@ function codexObservation(request, token, terminal, bytesRead, options, startedA
             return partial("codex_transcript_sample_stale", bytesRead, startedAt, token);
         }
     }
+    if (request.mode === "active_turn" && request.observed_at) {
+        const age = Date.parse(request.observed_at) - Date.parse(token.measured_at);
+        if (!Number.isFinite(age) ||
+            age < -5_000 ||
+            age > (options.maxSampleAgeMs ?? DEFAULT_MAX_SAMPLE_AGE_MS)) {
+            return partial("codex_transcript_sample_stale", bytesRead, startedAt, token);
+        }
+    }
     const witness = [
         request.session_id,
         request.turn_id ?? "status",
@@ -290,6 +318,8 @@ function codexObservation(request, token, terminal, bytesRead, options, startedA
         method: "codex_transcript_token_count",
         source_event: "codex.rollout_token_count",
         source_witness: createHash("sha256").update(witness).digest("hex"),
+        attestation: "derived",
+        confidence: "exact",
         bytes_read: bytesRead,
         io_duration_ms: elapsed(startedAt),
     };
@@ -298,7 +328,8 @@ function readClaudeContext(request, options, startedAt) {
     const readablePath = transcriptPathCandidates(request.transcript_path).find((candidate) => existsSync(candidate));
     if (!readablePath)
         return unsupported("runtime_context_telemetry_unavailable", startedAt);
-    const tail = readTail(readablePath, options.maxTailBytes ?? DEFAULT_TAIL_BYTES);
+    const tail = readTail(readablePath, options.maxTailBytes ??
+        (request.mode === "active_turn" ? ACTIVE_TURN_TAIL_BYTES : DEFAULT_TAIL_BYTES));
     if (!tail)
         return partial("claude_transcript_unreadable", 0, startedAt);
     const rows = parseRuntimeRows(tail.text);
@@ -306,10 +337,11 @@ function readClaudeContext(request, options, startedAt) {
     if (rows.some((row) => row.session_id !== undefined) && sessionRows.length === 0) {
         return partial("claude_transcript_session_mismatch", tail.bytes, startedAt);
     }
-    const candidateRows = request.mode === "turn"
+    const turnAttributed = request.mode === "turn" || request.mode === "active_turn";
+    const candidateRows = turnAttributed
         ? claudeAssistantRowsForTurn(sessionRows, request.turn_id)
         : sessionRows.filter((row) => row.type === "assistant");
-    if (request.mode === "turn" && candidateRows.length === 0) {
+    if (turnAttributed && candidateRows.length === 0) {
         return partial("claude_transcript_turn_not_found", tail.bytes, startedAt);
     }
     for (let index = candidateRows.length - 1; index >= 0; index--) {
@@ -324,6 +356,43 @@ function readClaudeContext(request, options, startedAt) {
         if (used === undefined) {
             return partial("context_used_tokens_not_reported", tail.bytes, startedAt);
         }
+        const model = stringValue(message?.model);
+        const capability = model ? claudeModelContextCapability(model) : undefined;
+        if (capability && row.timestamp) {
+            if (request.mode === "active_turn" && request.observed_at) {
+                const age = Date.parse(request.observed_at) - Date.parse(row.timestamp);
+                if (!Number.isFinite(age) ||
+                    age < -5_000 ||
+                    age > (options.maxSampleAgeMs ?? DEFAULT_MAX_SAMPLE_AGE_MS)) {
+                    return partial("claude_transcript_sample_stale", tail.bytes, startedAt, {
+                        used_tokens: used,
+                        measured_at: row.timestamp,
+                    });
+                }
+            }
+            const witness = [
+                request.session_id,
+                request.turn_id ?? "status",
+                row.timestamp,
+                used,
+                model,
+                capability.limit_tokens,
+                capability.authority,
+            ].join("\0");
+            return {
+                state: "observed",
+                used_tokens: used,
+                limit_tokens: capability.limit_tokens,
+                measured_at: row.timestamp,
+                method: "claude_transcript_usage_model_capability",
+                source_event: "claude.transcript_usage_model_capability",
+                source_witness: createHash("sha256").update(witness).digest("hex"),
+                attestation: "inferred",
+                confidence: "high",
+                bytes_read: tail.bytes,
+                io_duration_ms: elapsed(startedAt),
+            };
+        }
         return partial("claude_context_limit_tokens_not_reported", tail.bytes, startedAt, {
             used_tokens: used,
             measured_at: row.timestamp,
@@ -331,6 +400,203 @@ function readClaudeContext(request, options, startedAt) {
     }
     return partial("context_used_tokens_not_reported", tail.bytes, startedAt);
 }
+/**
+ * Versioned exact-name families from Anthropic's published model capability
+ * table. Unknown aliases deliberately stay missing: matching a product label
+ * or guessing from a family name would turn an estimate into fake precision.
+ */
+function claudeModelContextCapability(model) {
+    const normalized = model.toLowerCase();
+    const oneMillionTokenModels = new Set([
+        "claude-fable-5",
+        "claude-opus-5",
+        "claude-sonnet-5",
+        "claude-opus-4-8",
+        "claude-opus-4-7",
+        "claude-opus-4-6",
+        "claude-sonnet-4-6",
+    ]);
+    if (oneMillionTokenModels.has(normalized)) {
+        return { limit_tokens: 1_000_000, authority: "anthropic_model_capabilities_2026_08" };
+    }
+    if (normalized === "claude-haiku-4-5" || normalized === "claude-haiku-4-5-20251001") {
+        return { limit_tokens: 200_000, authority: "anthropic_model_capabilities_2026_08" };
+    }
+    return undefined;
+}
+function readCursorContext(request, options, startedAt) {
+    const cached = cursorDatabaseCache.get(request.session_id);
+    if (cached && existsSync(cached)) {
+        const sample = readCursorDatabase(cached, request.session_id);
+        if (sample.state === "found") {
+            return cursorObservation(request, sample.sample, options, startedAt);
+        }
+        cursorDatabaseCache.delete(request.session_id);
+    }
+    const databases = cursorDatabasePaths(options);
+    if (databases.length === 0) {
+        return partial("cursor_context_database_unavailable", 0, startedAt);
+    }
+    const matches = [];
+    let bytesRead = 0;
+    let unreadable = 0;
+    for (const databasePath of databases) {
+        const result = readCursorDatabase(databasePath, request.session_id);
+        bytesRead += result.state === "found" ? result.sample.bytes_read : result.bytes_read;
+        if (result.state === "unreadable")
+            unreadable += 1;
+        if (result.state !== "found")
+            continue;
+        matches.push(result.sample);
+    }
+    if (matches.length === 0) {
+        return partial(unreadable === databases.length
+            ? "cursor_context_database_unreadable"
+            : "cursor_context_session_not_found", bytesRead, startedAt);
+    }
+    matches.sort((left, right) => Date.parse(right.measured_at) - Date.parse(left.measured_at));
+    const newest = matches[0];
+    const tied = matches.filter((sample) => sample.measured_at === newest.measured_at);
+    if (tied.some((sample) => sample.used_percent !== newest.used_percent)) {
+        return partial("cursor_context_sample_ambiguous", bytesRead, startedAt);
+    }
+    cacheCursorDatabase(request.session_id, newest.database_path);
+    return cursorObservation(request, newest, options, startedAt);
+}
+function cursorObservation(request, sample, options, startedAt) {
+    if (!Number.isFinite(sample.used_percent) ||
+        sample.used_percent < 0 ||
+        sample.used_percent > 100) {
+        return partial("cursor_context_usage_invalid", sample.bytes_read, startedAt);
+    }
+    const sampleMs = Date.parse(sample.measured_at);
+    if (!Number.isFinite(sampleMs)) {
+        return partial("cursor_context_sample_time_not_reported", sample.bytes_read, startedAt);
+    }
+    if ((request.mode === "turn" || request.mode === "active_turn") && request.observed_at) {
+        const observedMs = Date.parse(request.observed_at);
+        const age = observedMs - sampleMs;
+        if (!Number.isFinite(observedMs) ||
+            age < -5_000 ||
+            age > (options.maxSampleAgeMs ?? DEFAULT_MAX_SAMPLE_AGE_MS)) {
+            return partial("cursor_context_sample_stale", sample.bytes_read, startedAt);
+        }
+    }
+    const witness = [request.session_id, sample.measured_at, sample.used_percent].join("\0");
+    return {
+        state: "observed",
+        used_percent: sample.used_percent,
+        measured_at: sample.measured_at,
+        method: "cursor_composer_context_percent",
+        source_event: "cursor.composer_context_percent",
+        source_witness: createHash("sha256").update(witness).digest("hex"),
+        attestation: "derived",
+        confidence: "high",
+        bytes_read: sample.bytes_read,
+        io_duration_ms: elapsed(startedAt),
+    };
+}
+function readCursorDatabase(databasePath, sessionId) {
+    try {
+        // Bun is the primary hook runtime. Node fallback processes fail closed here
+        // instead of importing a Bun-only module at startup.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { Database } = require("bun:sqlite");
+        const database = new Database(databasePath, { readonly: true });
+        const row = database
+            .query("SELECT value FROM ItemTable WHERE key = 'composer.composerData'")
+            .get();
+        database.close();
+        if (!row?.value)
+            return { state: "missing", bytes_read: 0 };
+        const text = typeof row.value === "string" ? row.value : Buffer.from(row.value).toString("utf8");
+        const bytesRead = Buffer.byteLength(text);
+        const parsed = objectValue(JSON.parse(text));
+        const composers = Array.isArray(parsed?.allComposers) ? parsed.allComposers : [];
+        for (const candidate of composers) {
+            const composer = objectValue(candidate);
+            if (stringValue(composer?.composerId) !== sessionId)
+                continue;
+            const usedPercent = numberValue(composer?.contextUsagePercent);
+            if (usedPercent === undefined)
+                return { state: "missing", bytes_read: bytesRead };
+            const measuredAt = cursorMeasuredAt(composer?.lastUpdatedAt);
+            if (!measuredAt)
+                return { state: "missing", bytes_read: bytesRead };
+            return {
+                state: "found",
+                sample: {
+                    used_percent: usedPercent,
+                    measured_at: measuredAt,
+                    bytes_read: bytesRead,
+                    database_path: databasePath,
+                },
+            };
+        }
+        return { state: "missing", bytes_read: bytesRead };
+    }
+    catch {
+        return { state: "unreadable", bytes_read: 0 };
+    }
+}
+function cursorMeasuredAt(value) {
+    if (typeof value === "string" && Number.isFinite(Date.parse(value))) {
+        return new Date(value).toISOString();
+    }
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0)
+        return undefined;
+    const milliseconds = value < 10_000_000_000 ? value * 1_000 : value;
+    const date = new Date(milliseconds);
+    return Number.isFinite(date.getTime()) ? date.toISOString() : undefined;
+}
+function cursorDatabasePaths(options) {
+    const roots = options.cursorRoots ?? defaultCursorRoots();
+    const limit = Math.max(1, Math.floor(options.maxCursorDatabases ?? DEFAULT_MAX_CURSOR_DATABASES));
+    const candidates = [];
+    for (const root of roots) {
+        let names;
+        try {
+            names = readdirSync(root).sort();
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            const databasePath = join(root, name, "state.vscdb");
+            try {
+                candidates.push({ path: databasePath, modified_ms: statSync(databasePath).mtimeMs });
+            }
+            catch {
+                // Removed or unreadable workspaces are not candidates.
+            }
+        }
+    }
+    return candidates
+        .sort((left, right) => right.modified_ms - left.modified_ms)
+        .slice(0, limit)
+        .map((candidate) => candidate.path);
+}
+function defaultCursorRoots() {
+    const roots = [resolve(homedir(), ".config", "Cursor", "User", "workspaceStorage")];
+    try {
+        if (existsSync("/mnt/c/Users")) {
+            for (const user of readdirSync("/mnt/c/Users")) {
+                roots.push(`/mnt/c/Users/${user}/AppData/Roaming/Cursor/User/workspaceStorage`);
+            }
+        }
+    }
+    catch {
+        // Non-WSL hosts do not expose this mount.
+    }
+    return roots;
+}
+function cacheCursorDatabase(sessionId, databasePath) {
+    cursorDatabaseCache.delete(sessionId);
+    cursorDatabaseCache.set(sessionId, databasePath);
+    while (cursorDatabaseCache.size > SESSION_CACHE_LIMIT) {
+        cursorDatabaseCache.delete(cursorDatabaseCache.keys().next().value);
+    }
+}
 /** Join assistant rows to the native CC prompt id through the transcript's
  * parent UUID chain. No UUID or prompt value crosses the reader boundary. */
 function claudeAssistantRowsForTurn(rows, turnId) {
@@ -360,6 +626,38 @@ function newestCodexToken(rows) {
     }
     return undefined;
 }
+function tokenWithinActiveTurn(rows, turnId) {
+    let startIndex = -1;
+    for (let index = rows.length - 1; index >= 0; index -= 1) {
+        const row = rows[index];
+        if (row.type === "event_msg" &&
+            row.payload?.type === "task_started" &&
+            row.payload.turn_id === turnId) {
+            startIndex = index;
+            break;
+        }
+    }
+    if (startIndex < 0)
+        return { state: "turn_missing" };
+    let token;
+    for (let index = startIndex + 1; index < rows.length; index += 1) {
+        const row = rows[index];
+        if (row.type === "event_msg" &&
+            (row.payload?.type === "task_started" || row.payload?.type === "task_complete")) {
+            break;
+        }
+        token = codexToken(row) ?? token;
+    }
+    return { state: "found", token };
+}
+function tokenAtOrAfter(rows, turnStartedAt) {
+    if (!turnStartedAt || !Number.isFinite(Date.parse(turnStartedAt)))
+        return undefined;
+    const token = newestCodexToken(rows);
+    if (!token?.measured_at)
+        return undefined;
+    return Date.parse(token.measured_at) >= Date.parse(turnStartedAt) ? token : undefined;
+}
 function tokenBeforeTerminal(rows, terminalIndex) {
     for (let index = terminalIndex - 1; index >= 0; index--) {
         const row = rows[index];
@@ -426,6 +724,9 @@ function parseRuntimeRows(text) {
 function stringValue(value) {
     return typeof value === "string" && value.length > 0 ? value : undefined;
 }
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
 function readTail(path, maxBytes) {
     let fd;
     try {