@zihanw/pi-forge 0.5.0 → 0.5.2

package/dist/context-diff-history.js

@@ -0,0 +1,84 @@
+/**
+ * Host-neutral rolling context-diff history.
+ *
+ * Keeps the last N turn snapshots captured from provider payloads and exposes
+ * the latest engine-computed diff plus compact summaries for recent turns.
+ */
+import { diffTurns, turnApproxTokens } from "./context-diff.js";
+import { extractTurnSnapshot } from "./context-diff-snapshot.js";
+export const CONTEXT_DIFF_HISTORY_LIMIT = 20;
+export function createContextDiffHistory() {
+    return {
+        turns: [],
+        nextTurnNumber: 1,
+        usageByTurnId: new Map(),
+        cacheReportingModels: new Set(),
+    };
+}
+/** Append a captured payload, evict old turns past the limit, and compute the latest diff. */
+export function appendContextDiffCapture(history, capture) {
+    const nextTurnNumber = history.nextTurnNumber ?? 1;
+    const turnId = capture.turnId ?? `turn-${nextTurnNumber}`;
+    history.nextTurnNumber = nextTurnNumber + 1;
+    const snapshot = extractTurnSnapshot({
+        ...capture,
+        turnId,
+    });
+    const previous = history.turns.at(-1);
+    history.turns.push(snapshot);
+    if (history.turns.length > CONTEXT_DIFF_HISTORY_LIMIT) {
+        const evicted = history.turns.shift();
+        if (evicted)
+            history.usageByTurnId.delete(evicted.turnId);
+    }
+    const diff = diffTurns(previous, snapshot);
+    history.latestDiff = diff;
+    return diff;
+}
+/** Attach the authoritative usage returned on the assistant message for one captured provider request. */
+export function attachContextDiffUsage(history, turnId, usage) {
+    if (!history.turns.some((turn) => turn.turnId === turnId))
+        return false;
+    const modelKey = `${usage.provider}/${usage.model}`;
+    const currentReportsCache = usage.cacheRead > 0 || usage.cacheWrite > 0;
+    const cacheReported = currentReportsCache || history.cacheReportingModels.has(modelKey);
+    if (currentReportsCache)
+        history.cacheReportingModels.add(modelKey);
+    const promptTokens = usage.input + usage.cacheRead + usage.cacheWrite;
+    history.usageByTurnId.set(turnId, {
+        ...usage,
+        promptTokens,
+        cacheHitRatio: cacheReported && promptTokens > 0 ? usage.cacheRead / promptTokens : null,
+        cacheStatus: cacheReported ? "reported" : "not-reported",
+    });
+    return true;
+}
+/** Build the response-shaped view: compact summaries for recent turns + latest full diff. */
+export function getContextDiffView(history) {
+    const turns = history.turns.map((turn, index) => {
+        const previous = index > 0 ? history.turns[index - 1] : undefined;
+        const diff = diffTurns(previous, turn);
+        return {
+            turnId: turn.turnId,
+            capturedAt: turn.capturedAt,
+            stackId: turn.stackId,
+            approxTokens: turnApproxTokens(turn),
+            blockCount: turn.blocks.length,
+            chars: turn.blocks.reduce((sum, block) => sum + block.chars, 0),
+            deltaTokens: diff.deltaTokens,
+            prefixTokens: diff.prefixTokens,
+            prefixRatio: diff.prefixRatio,
+            changedBlocks: diff.summary.changedBlocks,
+            usage: history.usageByTurnId.get(turn.turnId),
+        };
+    });
+    const latest = history.turns.length > 0 && history.latestDiff
+        ? {
+            turn: history.turns[history.turns.length - 1],
+            diff: history.latestDiff,
+            usage: history.usageByTurnId.get(history.turns[history.turns.length - 1].turnId),
+        }
+        : null;
+    return { turns, latest, latestDiff: history.latestDiff ?? null };
+}
+//# sourceMappingURL=context-diff-history.js.map

package/dist/context-diff-history.js.map

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

package/dist/context-diff-snapshot.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Host-neutral snapshot extraction from captured provider payloads.
+ *
+ * This module stays free of Node/DOM/Vue APIs so the same extraction logic can
+ * be reused by the web host and future non-web surfaces.
+ */
+import { type TurnSnapshot } from "./context-diff.ts";
+export interface ContextDiffCapture {
+    turnId?: string;
+    capturedAt: string;
+    stackId?: string;
+    payload?: unknown;
+    /** Secret-redacted, complete provider-request JSON used for diff identity. */
+    serializedPayload?: string;
+    text: string;
+}
+/** Convert a captured provider payload into an ordered TurnSnapshot of Blocks. */
+export declare function extractTurnSnapshot(capture: ContextDiffCapture): TurnSnapshot;
+//# sourceMappingURL=context-diff-snapshot.d.ts.map

package/dist/context-diff-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-diff-snapshot.d.ts","sourceRoot":"","sources":["../src/context-diff-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAyD,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7G,MAAM,WAAW,kBAAkB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAO7E"}

package/dist/context-diff-snapshot.js

@@ -0,0 +1,146 @@
+/**
+ * Host-neutral snapshot extraction from captured provider payloads.
+ *
+ * This module stays free of Node/DOM/Vue APIs so the same extraction logic can
+ * be reused by the web host and future non-web surfaces.
+ */
+import { createBlock, createTurnSnapshot, hashText } from "./context-diff.js";
+/** Convert a captured provider payload into an ordered TurnSnapshot of Blocks. */
+export function extractTurnSnapshot(capture) {
+    return createTurnSnapshot({
+        turnId: capture.turnId ?? capture.capturedAt,
+        capturedAt: capture.capturedAt,
+        stackId: capture.stackId ?? "",
+        blocks: extractBlocks(capture),
+    });
+}
+function extractBlocks(capture) {
+    const serializedPayload = parseSerializedPayload(capture.serializedPayload);
+    const payload = serializedPayload === undefined ? capture.payload : serializedPayload;
+    if (!isPlainObject(payload)) {
+        return [createBlock("payload-text", "payload", capture.text, capture.serializedPayload === undefined ? undefined : {
+                section: "payload",
+                serializedPayload: capture.serializedPayload,
+            })];
+    }
+    const blocks = [];
+    const messageKeyCounts = new Map();
+    for (const [key, value] of Object.entries(payload)) {
+        if (key === "system") {
+            blocks.push(createSystemBlock(value));
+            continue;
+        }
+        if (key === "messages" && Array.isArray(value) && value.length > 0) {
+            for (const message of value) {
+                const text = messageToText(message);
+                const role = messageRole(message);
+                const baseKey = `message-${keyPart(role)}-${hashText(`${role}\u0000${text}`).slice(0, 8)}`;
+                const occurrence = messageKeyCounts.get(baseKey) ?? 0;
+                messageKeyCounts.set(baseKey, occurrence + 1);
+                const messageKey = occurrence === 0 ? baseKey : `${baseKey}-${occurrence + 1}`;
+                blocks.push(createBlock(messageKey, role, text, {
+                    section: "messages",
+                    value: message,
+                }));
+            }
+            continue;
+        }
+        blocks.push(createRequestFieldBlock(key, value));
+    }
+    if (blocks.length > 0)
+        return blocks;
+    return [createBlock("payload", "payload", stringify(payload), {
+            section: "payload",
+            value: payload,
+        })];
+}
+function createRequestFieldBlock(key, value) {
+    return createBlock(`request-${key}`, "request", stringify({ [key]: value }, 2), {
+        section: "request",
+        field: key,
+        value,
+    });
+}
+function createSystemBlock(value) {
+    if (typeof value === "string") {
+        return createBlock("system", "system", value, {
+            section: "system",
+            value,
+        });
+    }
+    if (Array.isArray(value)) {
+        const systemText = contentBlocksToText(value);
+        return createBlock("system", "system", systemText || stringify(value), {
+            section: "system",
+            value,
+        });
+    }
+    return createBlock("system", "system", stringify(value), {
+        section: "system",
+        value,
+    });
+}
+function messageRole(message) {
+    return isPlainObject(message) && typeof message.role === "string" && message.role.length > 0
+        ? message.role
+        : "message";
+}
+function keyPart(value) {
+    const part = value.replace(/[^A-Za-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+    return part || "message";
+}
+function parseSerializedPayload(serializedPayload) {
+    if (serializedPayload === undefined)
+        return undefined;
+    try {
+        return JSON.parse(serializedPayload);
+    }
+    catch {
+        return undefined;
+    }
+}
+function stringify(value, space = 0) {
+    try {
+        const result = JSON.stringify(value, null, space);
+        return result === undefined ? String(value) : result;
+    }
+    catch {
+        return String(value);
+    }
+}
+function messageToText(message) {
+    if (typeof message === "string")
+        return message;
+    if (!isPlainObject(message))
+        return stringify(message);
+    const content = message.content;
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content))
+        return contentBlocksToText(content);
+    return stringify(message);
+}
+function contentBlocksToText(content) {
+    if (!Array.isArray(content))
+        return typeof content === "string" ? content : "";
+    const parts = [];
+    for (const part of content) {
+        if (isPlainObject(part) && typeof part.text === "string") {
+            parts.push(part.text);
+        }
+        else if (isPlainObject(part) && part.type === "image") {
+            parts.push("[image content]");
+        }
+        else if (typeof part === "string") {
+            parts.push(part);
+        }
+        else if (part !== undefined && part !== null) {
+            parts.push(stringify(part));
+        }
+    }
+    return parts.join("\n").trim();
+}
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=context-diff-snapshot.js.map

package/dist/context-diff-snapshot.js.map

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

package/dist/context-diff.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Host-neutral context diff engine.
+ *
+ * Pure functions only: no DOM, no Vue, no Node APIs. Consecutive turn
+ * snapshots are compared with a simple prefix-walk that models KV-cache
+ * reuse without attempting a full Myers diff.
+ */
+export interface Block {
+    key: string;
+    role: string;
+    text: string;
+    chars: number;
+    approxTokens: number;
+    hash: string;
+}
+export interface TurnSnapshot {
+    turnId: string;
+    capturedAt: string;
+    stackId: string;
+    blocks: Block[];
+}
+export type DiffBlockStatus = "same" | "added" | "removed" | "modified";
+export interface DiffBlock {
+    status: DiffBlockStatus;
+    before?: Block;
+    after?: Block;
+    tokenDelta: number;
+}
+export interface TurnDiffSummary {
+    sameBlocks: number;
+    addedBlocks: number;
+    removedBlocks: number;
+    modifiedBlocks: number;
+    changedBlocks: number;
+    /** Net tokens introduced by added or lengthened modified blocks. */
+    addedTokens: number;
+    /** Net tokens removed by removed or shortened modified blocks. */
+    removedTokens: number;
+    /** Net total token change (`addedTokens - removedTokens`). */
+    netTokens: number;
+}
+export interface TurnDiff {
+    blocks: DiffBlock[];
+    prefixTokens: number;
+    prefixRatio: number;
+    deltaTokens: number;
+    summary: TurnDiffSummary;
+}
+/** Estimate tokens from characters using the same chars/4 approximation as payload capture. */
+export declare function estimateApproxTokens(text: string): number;
+/** Pure string hash used as the block identity shortcut. */
+export declare function hashText(text: string): string;
+export declare function createBlock(key: string, role: string, text: string, serialized?: unknown): Block;
+export declare function createTurnSnapshot(input: {
+    turnId: string;
+    capturedAt?: string;
+    stackId?: string;
+    blocks?: Block[];
+}): TurnSnapshot;
+export declare function turnApproxTokens(turn: TurnSnapshot): number;
+/**
+ * Diff two consecutive turn snapshots.
+ *
+ * The cache-boundary walk compares block arrays positionally while hashes
+ * match. This preserves the serialized-prefix meaning even when a later
+ * block is moved. Classification uses stable block keys after the boundary so
+ * a middle insertion does not make every following block look modified.
+ */
+export declare function diffTurns(previous: TurnSnapshot | null | undefined, current: TurnSnapshot): TurnDiff;
+//# sourceMappingURL=context-diff.d.ts.map

package/dist/context-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-diff.d.ts","sourceRoot":"","sources":["../src/context-diff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,KAAK;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;CACzB;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAahG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB,GAAG,YAAY,CAOf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAG3D;AA+KD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACxB,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,EAAE,YAAY,GACnB,QAAQ,CAwCV"}

package/dist/context-diff.js

@@ -0,0 +1,259 @@
+/**
+ * Host-neutral context diff engine.
+ *
+ * Pure functions only: no DOM, no Vue, no Node APIs. Consecutive turn
+ * snapshots are compared with a simple prefix-walk that models KV-cache
+ * reuse without attempting a full Myers diff.
+ */
+/** Estimate tokens from characters using the same chars/4 approximation as payload capture. */
+export function estimateApproxTokens(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+/** Pure string hash used as the block identity shortcut. */
+export function hashText(text) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < text.length; i++) {
+        hash ^= text.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+export function createBlock(key, role, text, serialized) {
+    const hashInput = serialized === undefined
+        ? { role, text }
+        : { role, text, serialized };
+    const serializedHashInput = stringifyHashInput(hashInput);
+    return {
+        key,
+        role,
+        text,
+        chars: text.length,
+        approxTokens: estimateApproxTokens(text),
+        hash: hashText(serializedHashInput),
+    };
+}
+export function createTurnSnapshot(input) {
+    return {
+        turnId: input.turnId,
+        capturedAt: input.capturedAt ?? "",
+        stackId: input.stackId ?? "",
+        blocks: input.blocks ?? [],
+    };
+}
+export function turnApproxTokens(turn) {
+    const chars = turn.blocks.reduce((sum, block) => sum + block.chars, 0);
+    return chars === 0 ? 0 : Math.ceil(chars / 4);
+}
+function commonPrefixLength(a, b) {
+    const max = Math.min(a.length, b.length);
+    let index = 0;
+    while (index < max && a.charCodeAt(index) === b.charCodeAt(index)) {
+        index++;
+    }
+    return index;
+}
+function stringifyHashInput(value) {
+    try {
+        const serialized = JSON.stringify(value);
+        return serialized === undefined ? String(value) : serialized;
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * A block hash includes fields that affect the provider wire request, while
+ * the visible block text remains the useful prompt excerpt. When a hash
+ * differs because metadata changed without changing the excerpt, no part of
+ * that excerpt is safe to count as a reusable prefix.
+ */
+function safeCommonPrefixLength(before, after) {
+    if (before.role !== after.role || before.text === after.text)
+        return 0;
+    return commonPrefixLength(before.text, after.text);
+}
+function classify(before, after) {
+    if (before && after) {
+        if (before.hash === after.hash) {
+            return { status: "same", before, after, tokenDelta: 0 };
+        }
+        return {
+            status: "modified",
+            before,
+            after,
+            tokenDelta: 0,
+        };
+    }
+    if (before) {
+        return { status: "removed", before, tokenDelta: 0 };
+    }
+    return { status: "added", after, tokenDelta: 0 };
+}
+/**
+ * Allocate the request-level chars/4 delta across changed blocks. Per-block
+ * token deltas are deliberately based on character deltas, with the single
+ * request-level rounding remainder distributed across blocks so the chips and
+ * summary describe the same integer total.
+ */
+function assignTokenDeltas(blocks, deltaTokens) {
+    const candidates = blocks
+        .map((block) => ({
+        block,
+        charDelta: (block.after?.chars ?? 0) - (block.before?.chars ?? 0),
+    }))
+        .filter(({ block, charDelta }) => block.status !== "same" && charDelta !== 0);
+    if (candidates.length === 0)
+        return;
+    let allocated = 0;
+    for (const candidate of candidates) {
+        candidate.block.tokenDelta = Math.trunc(candidate.charDelta / 4);
+        allocated += candidate.block.tokenDelta;
+    }
+    let remainder = deltaTokens - allocated;
+    if (remainder === 0)
+        return;
+    const direction = remainder > 0 ? 1 : -1;
+    const preferred = candidates.filter(({ charDelta }) => direction > 0 ? charDelta > 0 : charDelta < 0);
+    const targets = preferred.length > 0 ? preferred : candidates;
+    const wholeShare = Math.trunc(Math.abs(remainder) / targets.length);
+    if (wholeShare > 0) {
+        for (const target of targets)
+            target.block.tokenDelta += direction * wholeShare;
+        remainder -= direction * wholeShare * targets.length;
+    }
+    for (let index = 0; remainder !== 0; index++) {
+        targets[index % targets.length].block.tokenDelta += direction;
+        remainder -= direction;
+    }
+}
+function summarize(blocks, netTokens) {
+    let sameBlocks = 0;
+    let addedBlocks = 0;
+    let removedBlocks = 0;
+    let modifiedBlocks = 0;
+    let addedTokens = 0;
+    let removedTokens = 0;
+    for (const block of blocks) {
+        switch (block.status) {
+            case "same":
+                sameBlocks++;
+                break;
+            case "added":
+                addedBlocks++;
+                if (block.tokenDelta > 0)
+                    addedTokens += block.tokenDelta;
+                if (block.tokenDelta < 0)
+                    removedTokens += -block.tokenDelta;
+                break;
+            case "removed":
+                removedBlocks++;
+                if (block.tokenDelta > 0)
+                    addedTokens += block.tokenDelta;
+                if (block.tokenDelta < 0)
+                    removedTokens += -block.tokenDelta;
+                break;
+            case "modified":
+                modifiedBlocks++;
+                if (block.tokenDelta > 0) {
+                    addedTokens += block.tokenDelta;
+                }
+                else {
+                    removedTokens += -block.tokenDelta;
+                }
+                break;
+        }
+    }
+    return {
+        sameBlocks,
+        addedBlocks,
+        removedBlocks,
+        modifiedBlocks,
+        changedBlocks: addedBlocks + removedBlocks + modifiedBlocks,
+        addedTokens,
+        removedTokens,
+        netTokens,
+    };
+}
+function hasUniqueStableKeys(blocks) {
+    const keys = blocks.map((block) => block.key);
+    return keys.every((key) => key.length > 0) && new Set(keys).size === keys.length;
+}
+function alignBlocks(beforeBlocks, afterBlocks) {
+    const afterKeys = new Set(afterBlocks.map((block) => block.key));
+    const useKeys = hasUniqueStableKeys(beforeBlocks)
+        && hasUniqueStableKeys(afterBlocks)
+        && beforeBlocks.some((block) => afterKeys.has(block.key));
+    if (!useKeys) {
+        return alignPositional(beforeBlocks, afterBlocks);
+    }
+    const beforeByKey = new Map(beforeBlocks.map((block) => [block.key, block]));
+    const beforeIndexByKey = new Map(beforeBlocks.map((block, index) => [block.key, index]));
+    const aligned = [];
+    let beforeCursor = 0;
+    let afterCursor = 0;
+    for (let afterIndex = 0; afterIndex < afterBlocks.length; afterIndex++) {
+        const after = afterBlocks[afterIndex];
+        const beforeIndex = beforeIndexByKey.get(after.key);
+        if (beforeIndex === undefined || beforeIndex < beforeCursor)
+            continue;
+        aligned.push(...alignPositional(beforeBlocks.slice(beforeCursor, beforeIndex), afterBlocks.slice(afterCursor, afterIndex)));
+        aligned.push({ before: beforeByKey.get(after.key), after });
+        beforeCursor = beforeIndex + 1;
+        afterCursor = afterIndex + 1;
+    }
+    aligned.push(...alignPositional(beforeBlocks.slice(beforeCursor), afterBlocks.slice(afterCursor)));
+    return aligned;
+}
+function alignPositional(beforeBlocks, afterBlocks) {
+    const maxLength = Math.max(beforeBlocks.length, afterBlocks.length);
+    return Array.from({ length: maxLength }, (_, index) => ({
+        before: beforeBlocks[index],
+        after: afterBlocks[index],
+    }));
+}
+/**
+ * Diff two consecutive turn snapshots.
+ *
+ * The cache-boundary walk compares block arrays positionally while hashes
+ * match. This preserves the serialized-prefix meaning even when a later
+ * block is moved. Classification uses stable block keys after the boundary so
+ * a middle insertion does not make every following block look modified.
+ */
+export function diffTurns(previous, current) {
+    const beforeBlocks = previous?.blocks ?? [];
+    const afterBlocks = current.blocks;
+    const diffBlocks = alignBlocks(beforeBlocks, afterBlocks).map(({ before, after }) => classify(before, after));
+    let prefixChars = 0;
+    let boundaryCrossed = false;
+    for (let index = 0; index < Math.max(beforeBlocks.length, afterBlocks.length); index++) {
+        const before = beforeBlocks[index];
+        const after = afterBlocks[index];
+        if (!boundaryCrossed) {
+            if (before && after && before.hash === after.hash) {
+                prefixChars += after.chars;
+                continue;
+            }
+            if (before && after) {
+                prefixChars += safeCommonPrefixLength(before, after);
+            }
+            boundaryCrossed = true;
+        }
+    }
+    const currentTokens = turnApproxTokens(current);
+    const previousTokens = previous ? turnApproxTokens(previous) : 0;
+    const currentChars = afterBlocks.reduce((sum, block) => sum + block.chars, 0);
+    const prefixTokens = !boundaryCrossed || prefixChars >= currentChars
+        ? currentTokens
+        : Math.min(currentTokens, Math.floor(prefixChars / 4));
+    const deltaTokens = currentTokens - previousTokens;
+    assignTokenDeltas(diffBlocks, deltaTokens);
+    const prefixRatio = currentTokens === 0 ? 0 : prefixTokens / currentTokens;
+    return {
+        blocks: diffBlocks,
+        prefixTokens,
+        prefixRatio,
+        deltaTokens,
+        summary: summarize(diffBlocks, deltaTokens),
+    };
+}
+//# sourceMappingURL=context-diff.js.map

package/dist/context-diff.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAgBhH;;;;;GAKG;AACH,OAAO,EACN,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,iCAAiC,EACjC,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,EACzB,mBAAmB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,iBAAiB,EACjB,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,iBAAiB,EACjB,sBAAsB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,EAAE,YAAY,QAwF/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAiBhH;;;;;GAKG;AACH,OAAO,EACN,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,iCAAiC,EACjC,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,EACzB,mBAAmB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,iBAAiB,EACjB,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,iBAAiB,EACjB,sBAAsB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,EAAE,YAAY,QA0F/C"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { registerLifecycleHandlers } from "./lifecycle.js";
-import { registerPayloadCommands, registerPayloadRequestHandler, armPayloadIntercept, clearPayloadCapture, webPayloadSnapshot } from "./payload-command.js";
+import { registerPayloadCommands, registerPayloadRequestHandler, armPayloadIntercept, clearPayloadCapture, recordProviderResponseUsage, webPayloadSnapshot } from "./payload-command.js";
 import { buildPreview } from "./preview.js";
 import { registerPresetCommand } from "./preset-command.js";
 import { registerProfileCommand } from "./profile-command.js";
@@ -11,6 +11,7 @@ import { ForgeWorkspace } from "./workspace.js";
 import { createToolPolicyRuntime } from "./runtime/tool-policy-runtime.js";
 import { createWebEditorRuntime } from "./runtime/web-editor-runtime.js";
 import { createCompileCycleState } from "./compile-cycle.js";
+import { getContextDiffView } from "./context-diff-history.js";
 import { createPayloadState } from "./payload-state.js";
 /**
  * Intentional public surface (0.5.0): the default Pi extension factory plus
@@ -68,7 +69,8 @@ export default function piForge(pi) {
             clearPayloadCapture(payloadState, ctx);
             return { ok: true, ...webPayloadSnapshot(payloadState) };
         },
-    }));
+        getContextDiff: () => ({ ok: true, ...getContextDiffView(payloadState.contextDiffHistory) }),
+    }), () => pi.events);
     registerLifecycleHandlers(pi, workspace, compileCycle, {
         reloadStacks: stackRuntime.reloadStacks,
         disposePromptStackRuntime: stackRuntime.dispose,
@@ -85,6 +87,7 @@ export default function piForge(pi) {
             workspace.startHostPort(pi.events);
         },
         disposeForgeWorkspace: () => workspace.dispose(),
+        recordProviderResponseUsage: (message) => recordProviderResponseUsage(payloadState, message),
     });
     registerPayloadRequestHandler(pi, payloadState, () => currentActive());
     registerPayloadCommands(pi, payloadState);