@nervekit/agent 0.1.0

package/dist/harness/compaction/cut-points.js

@@ -0,0 +1,106 @@
+import { estimateTokens } from "./usage.js";
+function findValidCutPoints(entries, startIndex, endIndex) {
+    const cutPoints = [];
+    for (let i = startIndex; i < endIndex; i++) {
+        const entry = entries[i];
+        switch (entry.type) {
+            case "message": {
+                const role = entry.message.role;
+                switch (role) {
+                    case "bashExecution":
+                    case "custom":
+                    case "branchSummary":
+                    case "compactionSummary":
+                    case "user":
+                    case "assistant":
+                        cutPoints.push(i);
+                        break;
+                    case "toolResult":
+                        break;
+                }
+                break;
+            }
+            case "thinking_level_change":
+            case "model_change":
+            case "active_tools_change":
+            case "compaction":
+            case "branch_summary":
+            case "custom":
+            case "custom_message":
+            case "label":
+            case "conversation_info":
+            case "leaf":
+                break;
+        }
+        if (entry.type === "branch_summary" || entry.type === "custom_message") {
+            cutPoints.push(i);
+        }
+    }
+    return cutPoints;
+}
+/** Find the user-visible message that starts the turn containing an entry. */
+export function findTurnStartIndex(entries, entryIndex, startIndex) {
+    for (let i = entryIndex; i >= startIndex; i--) {
+        const entry = entries[i];
+        if (entry.type === "branch_summary" || entry.type === "custom_message") {
+            return i;
+        }
+        if (entry.type === "message") {
+            const role = entry.message.role;
+            if (role === "user" || role === "bashExecution") {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+/** Find the compaction cut point that keeps approximately the requested recent-token budget. */
+export function findCutPoint(entries, startIndex, endIndex, keepRecentTokens) {
+    const cutPoints = findValidCutPoints(entries, startIndex, endIndex);
+    if (cutPoints.length === 0) {
+        return {
+            firstKeptEntryIndex: startIndex,
+            turnStartIndex: -1,
+            isSplitTurn: false,
+        };
+    }
+    let accumulatedTokens = 0;
+    let cutIndex = cutPoints[0];
+    for (let i = endIndex - 1; i >= startIndex; i--) {
+        const entry = entries[i];
+        if (entry.type !== "message")
+            continue;
+        const messageTokens = estimateTokens(entry.message);
+        accumulatedTokens += messageTokens;
+        if (accumulatedTokens >= keepRecentTokens) {
+            for (let c = 0; c < cutPoints.length; c++) {
+                if (cutPoints[c] >= i) {
+                    cutIndex = cutPoints[c];
+                    break;
+                }
+            }
+            break;
+        }
+    }
+    while (cutIndex > startIndex) {
+        const prevEntry = entries[cutIndex - 1];
+        if (prevEntry.type === "compaction") {
+            break;
+        }
+        if (prevEntry.type === "message") {
+            break;
+        }
+        cutIndex--;
+    }
+    const cutEntry = entries[cutIndex];
+    const isUserMessage = cutEntry.type === "message" && cutEntry.message.role === "user";
+    const turnStartIndex = isUserMessage
+        ? -1
+        : findTurnStartIndex(entries, cutIndex, startIndex);
+    return {
+        firstKeptEntryIndex: cutIndex,
+        turnStartIndex,
+        isSplitTurn: !isUserMessage && turnStartIndex !== -1,
+    };
+}
+//# sourceMappingURL=cut-points.js.map

package/dist/harness/compaction/cut-points.js.map

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

package/dist/harness/compaction/overflow.d.ts

@@ -0,0 +1,3 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+export declare function isContextOverflowAssistantMessage(message: AssistantMessage, contextWindow?: number): boolean;
+//# sourceMappingURL=overflow.d.ts.map

package/dist/harness/compaction/overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../../src/harness/compaction/overflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoC9D,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,gBAAgB,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CA8BT"}

package/dist/harness/compaction/overflow.js

@@ -0,0 +1,54 @@
+const OVERFLOW_PATTERNS = [
+    /prompt is too long/i,
+    /request_too_large/i,
+    /input is too long for requested model/i,
+    /exceeds the context window/i,
+    /exceeds (?:the )?(?:model'?s )?maximum context length of [\d,]+ tokens?/i,
+    /input token count.*exceeds the maximum/i,
+    /maximum prompt length is \d+/i,
+    /reduce the length of the messages/i,
+    /maximum context length is [\d,]+ tokens/i,
+    /exceeds (?:the )?maximum allowed input length of [\d,]+ tokens?/i,
+    /input \([\d,]+ tokens\) is longer than the model'?s context length \([\d,]+ tokens\)/i,
+    /exceeds the limit of [\d,]+/i,
+    /exceeds the available context size/i,
+    /greater than the context length/i,
+    /context window exceeds limit/i,
+    /exceeded model token limit/i,
+    /too large for model with [\d,]+ maximum context length/i,
+    /model_context_window_exceeded/i,
+    /prompt too long; exceeded (?:max )?context length/i,
+    /context[_ ]length[_ ]exceeded/i,
+    /too many tokens/i,
+    /token limit exceeded/i,
+    /^4(?:00|13)\s*(?:status code)?\s*\(no body\)/i,
+];
+const NON_OVERFLOW_PATTERNS = [
+    /^(Throttling error|Service unavailable):/i,
+    /rate limit/i,
+    /too many requests/i,
+    /throttling/i,
+    /service unavailable/i,
+];
+export function isContextOverflowAssistantMessage(message, contextWindow) {
+    if (message.stopReason === "error" && message.errorMessage) {
+        const isNonOverflow = NON_OVERFLOW_PATTERNS.some((pattern) => pattern.test(message.errorMessage ?? ""));
+        if (!isNonOverflow &&
+            OVERFLOW_PATTERNS.some((pattern) => pattern.test(message.errorMessage ?? ""))) {
+            return true;
+        }
+    }
+    if (contextWindow && contextWindow > 0) {
+        const inputTokens = message.usage.input + message.usage.cacheRead;
+        if (message.stopReason === "stop" && inputTokens > contextWindow) {
+            return true;
+        }
+        if (message.stopReason === "length" &&
+            message.usage.output === 0 &&
+            inputTokens >= contextWindow * 0.99) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=overflow.js.map

package/dist/harness/compaction/overflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.js","sourceRoot":"","sources":["../../../src/harness/compaction/overflow.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG;IACxB,qBAAqB;IACrB,oBAAoB;IACpB,wCAAwC;IACxC,6BAA6B;IAC7B,0EAA0E;IAC1E,yCAAyC;IACzC,+BAA+B;IAC/B,oCAAoC;IACpC,0CAA0C;IAC1C,kEAAkE;IAClE,uFAAuF;IACvF,8BAA8B;IAC9B,qCAAqC;IACrC,kCAAkC;IAClC,+BAA+B;IAC/B,6BAA6B;IAC7B,yDAAyD;IACzD,gCAAgC;IAChC,oDAAoD;IACpD,gCAAgC;IAChC,kBAAkB;IAClB,uBAAuB;IACvB,+CAA+C;CAChD,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,2CAA2C;IAC3C,aAAa;IACb,oBAAoB;IACpB,aAAa;IACb,sBAAsB;CACvB,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAC/C,OAAyB,EACzB,aAAsB;IAEtB,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3D,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC3D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CACzC,CAAC;QACF,IACE,CAAC,aAAa;YACd,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CACjC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CACzC,EACD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAClE,IAAI,OAAO,CAAC,UAAU,KAAK,MAAM,IAAI,WAAW,GAAG,aAAa,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IACE,OAAO,CAAC,UAAU,KAAK,QAAQ;YAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAC1B,WAAW,IAAI,aAAa,GAAG,IAAI,EACnC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/harness/compaction/policy.d.ts

@@ -0,0 +1,8 @@
+import type { AutoCompactionPolicy, CompactionSettings } from "./types.js";
+/** Default compaction settings used by the harness. */
+export declare const DEFAULT_COMPACTION_SETTINGS: CompactionSettings;
+export declare function deriveAutoCompactionPolicy(contextWindow: number, enabled?: boolean): AutoCompactionPolicy;
+export declare function shouldAutoCompact(contextTokens: number | null | undefined, policy: AutoCompactionPolicy): boolean;
+/** Return whether context usage exceeds the configured compaction threshold. */
+export declare function shouldCompact(contextTokens: number, contextWindow: number, settings: CompactionSettings): boolean;
+//# sourceMappingURL=policy.d.ts.map

package/dist/harness/compaction/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/harness/compaction/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3E,uDAAuD;AACvD,eAAO,MAAM,2BAA2B,EAAE,kBAIzC,CAAC;AAYF,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,UAAO,GACb,oBAAoB,CAsCtB;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAWT;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAGT"}

package/dist/harness/compaction/policy.js

@@ -0,0 +1,57 @@
+/** Default compaction settings used by the harness. */
+export const DEFAULT_COMPACTION_SETTINGS = {
+    enabled: true,
+    reserveTokens: 16384,
+    keepRecentTokens: 20000,
+};
+const AUTO_COMPACTION_THRESHOLD_PERCENT = 90;
+const AUTO_COMPACTION_KEEP_RECENT_PERCENT = 10;
+const AUTO_COMPACTION_MIN_KEEP_RECENT_TOKENS = 4_000;
+const AUTO_COMPACTION_MAX_KEEP_RECENT_TOKENS = 50_000;
+const AUTO_COMPACTION_SUMMARY_RESERVE_TOKENS = 16_384;
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+export function deriveAutoCompactionPolicy(contextWindow, enabled = true) {
+    const normalizedWindow = Number.isFinite(contextWindow)
+        ? Math.max(0, Math.floor(contextWindow))
+        : 0;
+    if (normalizedWindow <= 0) {
+        return {
+            enabled,
+            contextWindow: 0,
+            thresholdPercent: AUTO_COMPACTION_THRESHOLD_PERCENT,
+            thresholdTokens: 0,
+            triggerReserveTokens: 0,
+            keepRecentTokens: 0,
+            summaryReserveTokens: AUTO_COMPACTION_SUMMARY_RESERVE_TOKENS,
+        };
+    }
+    const thresholdTokens = Math.floor(normalizedWindow * (AUTO_COMPACTION_THRESHOLD_PERCENT / 100));
+    const maxKeepRecentTokens = Math.min(AUTO_COMPACTION_MAX_KEEP_RECENT_TOKENS, Math.floor(normalizedWindow * 0.5));
+    const keepRecentTokens = clamp(Math.floor(normalizedWindow * (AUTO_COMPACTION_KEEP_RECENT_PERCENT / 100)), Math.min(AUTO_COMPACTION_MIN_KEEP_RECENT_TOKENS, maxKeepRecentTokens), maxKeepRecentTokens);
+    return {
+        enabled,
+        contextWindow: normalizedWindow,
+        thresholdPercent: AUTO_COMPACTION_THRESHOLD_PERCENT,
+        thresholdTokens,
+        triggerReserveTokens: Math.max(0, normalizedWindow - thresholdTokens),
+        keepRecentTokens,
+        summaryReserveTokens: AUTO_COMPACTION_SUMMARY_RESERVE_TOKENS,
+    };
+}
+export function shouldAutoCompact(contextTokens, policy) {
+    if (!policy.enabled ||
+        policy.contextWindow <= 0 ||
+        policy.thresholdTokens <= 0) {
+        return false;
+    }
+    return (typeof contextTokens === "number" && contextTokens >= policy.thresholdTokens);
+}
+/** Return whether context usage exceeds the configured compaction threshold. */
+export function shouldCompact(contextTokens, contextWindow, settings) {
+    if (!settings.enabled || contextWindow <= 0)
+        return false;
+    return contextTokens > contextWindow - settings.reserveTokens;
+}
+//# sourceMappingURL=policy.js.map

package/dist/harness/compaction/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/harness/compaction/policy.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,KAAK;IACpB,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAC7C,MAAM,mCAAmC,GAAG,EAAE,CAAC;AAC/C,MAAM,sCAAsC,GAAG,KAAK,CAAC;AACrD,MAAM,sCAAsC,GAAG,MAAM,CAAC;AACtD,MAAM,sCAAsC,GAAG,MAAM,CAAC;AAEtD,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,aAAqB,EACrB,OAAO,GAAG,IAAI;IAEd,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC,CAAC;IACN,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO;YACP,aAAa,EAAE,CAAC;YAChB,gBAAgB,EAAE,iCAAiC;YACnD,eAAe,EAAE,CAAC;YAClB,oBAAoB,EAAE,CAAC;YACvB,gBAAgB,EAAE,CAAC;YACnB,oBAAoB,EAAE,sCAAsC;SAC7D,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAChC,gBAAgB,GAAG,CAAC,iCAAiC,GAAG,GAAG,CAAC,CAC7D,CAAC;IACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAClC,sCAAsC,EACtC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,GAAG,CAAC,CACnC,CAAC;IACF,MAAM,gBAAgB,GAAG,KAAK,CAC5B,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,mCAAmC,GAAG,GAAG,CAAC,CAAC,EAC1E,IAAI,CAAC,GAAG,CAAC,sCAAsC,EAAE,mBAAmB,CAAC,EACrE,mBAAmB,CACpB,CAAC;IAEF,OAAO;QACL,OAAO;QACP,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,iCAAiC;QACnD,eAAe;QACf,oBAAoB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;QACrE,gBAAgB;QAChB,oBAAoB,EAAE,sCAAsC;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAwC,EACxC,MAA4B;IAE5B,IACE,CAAC,MAAM,CAAC,OAAO;QACf,MAAM,CAAC,aAAa,IAAI,CAAC;QACzB,MAAM,CAAC,eAAe,IAAI,CAAC,EAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,IAAI,MAAM,CAAC,eAAe,CAC7E,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAC3B,aAAqB,EACrB,aAAqB,EACrB,QAA4B;IAE5B,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,aAAa,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;AAChE,CAAC"}

package/dist/harness/compaction/types.d.ts

@@ -0,0 +1,79 @@
+import type { AgentMessage } from "../../types.js";
+import type { FileOperations } from "./utils.js";
+/** File-operation details stored on generated compaction entries. */
+export interface CompactionDetails {
+    /** Files read in the compacted history. */
+    readFiles: string[];
+    /** Files modified in the compacted history. */
+    modifiedFiles: string[];
+}
+/** Generated compaction data ready to be persisted as a compaction entry. */
+export interface CompactionResult<T = unknown> {
+    /** Summary text that replaces compacted history in future context. */
+    summary: string;
+    /** Entry id where retained history starts. */
+    firstKeptEntryId: string;
+    /** Estimated context tokens before compaction. */
+    tokensBefore: number;
+    /** Optional implementation-specific details stored with the compaction entry. */
+    details?: T;
+}
+/** Compaction thresholds and retention settings. */
+export interface CompactionSettings {
+    /** Enable automatic compaction decisions. */
+    enabled: boolean;
+    /** Tokens reserved for summary prompt and output. */
+    reserveTokens: number;
+    /** Approximate recent-context tokens to keep after compaction. */
+    keepRecentTokens: number;
+}
+export type AutoCompactionReason = "threshold" | "overflow" | "manual";
+export interface AutoCompactionPolicy {
+    enabled: boolean;
+    contextWindow: number;
+    thresholdPercent: number;
+    thresholdTokens: number;
+    triggerReserveTokens: number;
+    keepRecentTokens: number;
+    summaryReserveTokens: number;
+}
+/** Estimated context-token usage for a message list. */
+export interface ContextUsageEstimate {
+    /** Estimated total context tokens. */
+    tokens: number;
+    /** Tokens reported by the most recent assistant usage block. */
+    usageTokens: number;
+    /** Estimated tokens after the most recent assistant usage block. */
+    trailingTokens: number;
+    /** Index of the message that provided usage, or null when none exists. */
+    lastUsageIndex: number | null;
+}
+/** Cut point selected for compaction. */
+export interface CutPointResult {
+    /** Index of the first entry retained after compaction. */
+    firstKeptEntryIndex: number;
+    /** Index of the turn-start entry when the cut splits a turn, otherwise -1. */
+    turnStartIndex: number;
+    /** Whether the selected cut point splits an in-progress turn. */
+    isSplitTurn: boolean;
+}
+/** Prepared inputs for a compaction run. */
+export interface CompactionPreparation {
+    /** Entry id where retained history starts. */
+    firstKeptEntryId: string;
+    /** Messages summarized into the history summary. */
+    messagesToSummarize: AgentMessage[];
+    /** Prefix messages summarized separately when compaction splits a turn. */
+    turnPrefixMessages: AgentMessage[];
+    /** Whether compaction splits a turn. */
+    isSplitTurn: boolean;
+    /** Estimated context tokens before compaction. */
+    tokensBefore: number;
+    /** Previous compaction summary used for iterative updates. */
+    previousSummary?: string;
+    /** File operations extracted from summarized history. */
+    fileOps: FileOperations;
+    /** Settings used to prepare compaction. */
+    settings: CompactionSettings;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/compaction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/harness/compaction/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,mBAAmB,EAAE,YAAY,EAAE,CAAC;IACpC,2EAA2E;IAC3E,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,OAAO,EAAE,cAAc,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,kBAAkB,CAAC;CAC9B"}

package/dist/harness/compaction/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/compaction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/compaction/types.ts"],"names":[],"mappings":""}

package/dist/harness/compaction/usage.d.ts

@@ -0,0 +1,30 @@
+import type { Usage } from "@earendil-works/pi-ai";
+import type { ContextUsage } from "@nervekit/shared";
+import type { AgentMessage } from "../../types.js";
+import type { CompactionEntry, ConversationTreeEntry } from "../conversation/entries.js";
+import type { ContextUsageEstimate } from "./types.js";
+/** Calculate total context tokens from provider usage. */
+export declare function calculateContextTokens(usage: Usage): number;
+/** Return usage from the last successful assistant message in conversation entries. */
+export declare function getLastAssistantUsage(entries: ConversationTreeEntry[]): Usage | undefined;
+/** Estimate context tokens for messages using provider usage when available. */
+export declare function estimateContextTokens(messages: AgentMessage[]): ContextUsageEstimate;
+/** Return the most recent compaction entry in a branch, if any. */
+export declare function getLatestCompactionEntry(entries: ConversationTreeEntry[]): CompactionEntry | undefined;
+/**
+ * Compute compaction-aware context-window usage.
+ *
+ * Mirrors pi's `AgentConversation.getContextUsage()`:
+ * - `contextWindow <= 0` -> usage unknown (`tokens`/`percent` null).
+ * - After the latest compaction, usage is unknown until a fresh, non-aborted
+ *   assistant response provides usage again.
+ * - Otherwise estimate from messages and report a percentage of the window.
+ *
+ * @param messages Reconstructed branch messages (e.g. from `buildConversationContext`).
+ * @param branchEntries Raw branch entries used to detect the compaction boundary.
+ * @param contextWindow The selected model's context window (0 when unknown).
+ */
+export declare function computeContextUsage(messages: AgentMessage[], branchEntries: ConversationTreeEntry[], contextWindow: number): ContextUsage;
+/** Estimate token count for one message using a conservative character heuristic. */
+export declare function estimateTokens(message: AgentMessage): number;
+//# sourceMappingURL=usage.d.ts.map

package/dist/harness/compaction/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/harness/compaction/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAUvD,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAK3D;AAgBD,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,qBAAqB,EAAE,GAC/B,KAAK,GAAG,SAAS,CASnB;AAYD,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,oBAAoB,CA4BtB;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,qBAAqB,EAAE,GAC/B,eAAe,GAAG,SAAS,CAM7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,qBAAqB,EAAE,EACtC,aAAa,EAAE,MAAM,GACpB,YAAY,CA2Bd;AAsBD,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA6C5D"}

package/dist/harness/compaction/usage.js

@@ -0,0 +1,177 @@
+function safeJsonStringify(value) {
+    try {
+        return JSON.stringify(value) ?? "undefined";
+    }
+    catch {
+        return "[unserializable]";
+    }
+}
+/** Calculate total context tokens from provider usage. */
+export function calculateContextTokens(usage) {
+    return (usage.totalTokens ||
+        usage.input + usage.output + usage.cacheRead + usage.cacheWrite);
+}
+function getAssistantUsage(msg) {
+    if (msg.role === "assistant" && "usage" in msg) {
+        const assistantMsg = msg;
+        if (assistantMsg.stopReason !== "aborted" &&
+            assistantMsg.stopReason !== "error" &&
+            assistantMsg.usage) {
+            return assistantMsg.usage;
+        }
+    }
+    return undefined;
+}
+/** Return usage from the last successful assistant message in conversation entries. */
+export function getLastAssistantUsage(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.type === "message") {
+            const usage = getAssistantUsage(entry.message);
+            if (usage)
+                return usage;
+        }
+    }
+    return undefined;
+}
+function getLastAssistantUsageInfo(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const usage = getAssistantUsage(messages[i]);
+        if (usage)
+            return { usage, index: i };
+    }
+    return undefined;
+}
+/** Estimate context tokens for messages using provider usage when available. */
+export function estimateContextTokens(messages) {
+    const usageInfo = getLastAssistantUsageInfo(messages);
+    if (!usageInfo) {
+        let estimated = 0;
+        for (const message of messages) {
+            estimated += estimateTokens(message);
+        }
+        return {
+            tokens: estimated,
+            usageTokens: 0,
+            trailingTokens: estimated,
+            lastUsageIndex: null,
+        };
+    }
+    const usageTokens = calculateContextTokens(usageInfo.usage);
+    let trailingTokens = 0;
+    for (let i = usageInfo.index + 1; i < messages.length; i++) {
+        trailingTokens += estimateTokens(messages[i]);
+    }
+    return {
+        tokens: usageTokens + trailingTokens,
+        usageTokens,
+        trailingTokens,
+        lastUsageIndex: usageInfo.index,
+    };
+}
+/** Return the most recent compaction entry in a branch, if any. */
+export function getLatestCompactionEntry(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.type === "compaction")
+            return entry;
+    }
+    return undefined;
+}
+/**
+ * Compute compaction-aware context-window usage.
+ *
+ * Mirrors pi's `AgentConversation.getContextUsage()`:
+ * - `contextWindow <= 0` -> usage unknown (`tokens`/`percent` null).
+ * - After the latest compaction, usage is unknown until a fresh, non-aborted
+ *   assistant response provides usage again.
+ * - Otherwise estimate from messages and report a percentage of the window.
+ *
+ * @param messages Reconstructed branch messages (e.g. from `buildConversationContext`).
+ * @param branchEntries Raw branch entries used to detect the compaction boundary.
+ * @param contextWindow The selected model's context window (0 when unknown).
+ */
+export function computeContextUsage(messages, branchEntries, contextWindow) {
+    if (contextWindow <= 0) {
+        return { tokens: null, contextWindow: 0, percent: null };
+    }
+    const latestCompaction = getLatestCompactionEntry(branchEntries);
+    if (latestCompaction) {
+        const compactionIndex = branchEntries.lastIndexOf(latestCompaction);
+        let hasPostCompactionUsage = false;
+        for (let i = branchEntries.length - 1; i > compactionIndex; i--) {
+            const entry = branchEntries[i];
+            if (entry.type === "message") {
+                const usage = getAssistantUsage(entry.message);
+                if (usage) {
+                    hasPostCompactionUsage = calculateContextTokens(usage) > 0;
+                    break;
+                }
+            }
+        }
+        if (!hasPostCompactionUsage) {
+            return { tokens: null, contextWindow, percent: null };
+        }
+    }
+    const estimate = estimateContextTokens(messages);
+    const percent = (estimate.tokens / contextWindow) * 100;
+    return { tokens: estimate.tokens, contextWindow, percent };
+}
+const ESTIMATED_IMAGE_CHARS = 4800;
+function estimateTextAndImageContentChars(content) {
+    if (typeof content === "string") {
+        return content.length;
+    }
+    let chars = 0;
+    for (const block of content) {
+        if (block.type === "text" && block.text) {
+            chars += block.text.length;
+        }
+        else if (block.type === "image") {
+            chars += ESTIMATED_IMAGE_CHARS;
+        }
+    }
+    return chars;
+}
+/** Estimate token count for one message using a conservative character heuristic. */
+export function estimateTokens(message) {
+    let chars = 0;
+    switch (message.role) {
+        case "user": {
+            chars = estimateTextAndImageContentChars(message.content);
+            return Math.ceil(chars / 4);
+        }
+        case "assistant": {
+            const assistant = message;
+            for (const block of assistant.content) {
+                if (block.type === "text") {
+                    chars += block.text.length;
+                }
+                else if (block.type === "thinking") {
+                    chars += block.thinking.length;
+                }
+                else if (block.type === "toolCall") {
+                    chars +=
+                        block.name.length + safeJsonStringify(block.arguments).length;
+                }
+            }
+            return Math.ceil(chars / 4);
+        }
+        case "custom":
+        case "toolResult": {
+            chars = estimateTextAndImageContentChars(message.content);
+            return Math.ceil(chars / 4);
+        }
+        case "bashExecution": {
+            chars = message.command.length + message.output.length;
+            return Math.ceil(chars / 4);
+        }
+        case "branchSummary":
+        case "compactionSummary": {
+            chars = message.summary.length;
+            return Math.ceil(chars / 4);
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=usage.js.map

package/dist/harness/compaction/usage.js.map

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

package/dist/harness/compaction/utils.d.ts

@@ -0,0 +1,25 @@
+import type { Message } from "@earendil-works/pi-ai";
+import type { AgentMessage } from "../../types.js";
+/** File paths touched by a conversation branch or compaction range. */
+export interface FileOperations {
+    /** Files read but not necessarily modified. */
+    read: Set<string>;
+    /** Files written by full-file write operations. */
+    written: Set<string>;
+    /** Files modified by edit operations. */
+    edited: Set<string>;
+}
+/** Create an empty file-operation accumulator. */
+export declare function createFileOps(): FileOperations;
+/** Add file operations from assistant tool calls to an accumulator. */
+export declare function extractFileOpsFromMessage(message: AgentMessage, fileOps: FileOperations): void;
+/** Compute sorted read-only and modified file lists from accumulated operations. */
+export declare function computeFileLists(fileOps: FileOperations): {
+    readFiles: string[];
+    modifiedFiles: string[];
+};
+/** Format file lists as summary metadata tags. */
+export declare function formatFileOperations(readFiles: string[], modifiedFiles: string[]): string;
+/** Serialize LLM messages to plain text for summarization prompts. */
+export declare function serializeConversation(messages: Message[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/harness/compaction/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/harness/compaction/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,mDAAmD;IACnD,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,yCAAyC;IACzC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,kDAAkD;AAClD,wBAAgB,aAAa,IAAI,cAAc,CAM9C;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,cAAc,GACtB,IAAI,CA2BN;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAKA;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CAYR;AAkBD,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAyDjE"}