pi-smart-compact 9.7.1 → 10.0.1

package/dist/app/smart-compact-input.d.ts

@@ -4,7 +4,7 @@ export interface SmartCompactInput {
     mode?: CompactionMode;
     verbose: boolean;
     dryRun: boolean;
-    action?: "metrics" | "dashboard" | "restore" | "loops" | "settings" | "forget";
+    action?: "metrics" | "dashboard" | "restore" | "loops" | "settings" | "forget" | "storage" | "trim" | "handoff";
     focus?: string;
     note?: string;
     maxLlmCalls?: number;

package/dist/app/smart-compact-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-compact-input.d.ts","sourceRoot":"","sources":["../../src/app/smart-compact-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EACH,SAAS,GACT,WAAW,GACX,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAyHjC,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GACvC,uBAAuB,CAqEzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,uBAAuB,CA+CzB"}
+{"version":3,"file":"smart-compact-input.d.ts","sourceRoot":"","sources":["../../src/app/smart-compact-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EACH,SAAS,GACT,WAAW,GACX,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA4HjC,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GACvC,uBAAuB,CAqEzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,uBAAuB,CA+CzB"}

package/dist/app/smart-compact-policy.d.ts

@@ -31,6 +31,6 @@ export interface SmartCompactPolicy {
     update(patch: Partial<DesiredSmartCompactPolicy>, ctx: ExtensionContext): SmartCompactPolicyUpdate;
     reset(field: SmartCompactPolicyField, ctx: ExtensionContext): SmartCompactPolicyUpdate;
 }
-export declare function createSmartCompactPolicy(pi: ExtensionAPI): SmartCompactPolicy;
+export declare function createSmartCompactPolicy(pi: ExtensionAPI, syncTools: () => void): SmartCompactPolicy;
 export {};
 //# sourceMappingURL=smart-compact-policy.d.ts.map

package/dist/app/smart-compact-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-compact-policy.d.ts","sourceRoot":"","sources":["../../src/app/smart-compact-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,KAAK,eAAe,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAExD,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,eAAe,CAAC;IACjC,iFAAiF;IACjF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAOD,MAAM,MAAM,uBAAuB,GAAG,MAAM,yBAAyB,CAAC;AAEtE,KAAK,wBAAwB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,IAAI,0BAA0B,CAAC;IACvC,eAAe,IAAI,QAAQ,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChE,kBAAkB,IAAI,OAAO,CAAC;IAC9B,oBAAoB,IAAI,OAAO,CAAC;IAChC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,MAAM,CACJ,KAAK,EAAE,OAAO,CAAC,yBAAyB,CAAC,EACzC,GAAG,EAAE,gBAAgB,GACpB,wBAAwB,CAAC;IAC5B,KAAK,CACH,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,gBAAgB,GACpB,wBAAwB,CAAC;CAC7B;AAuFD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,kBAAkB,CA4G7E"}
+{"version":3,"file":"smart-compact-policy.d.ts","sourceRoot":"","sources":["../../src/app/smart-compact-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUjD,KAAK,eAAe,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAExD,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,eAAe,CAAC;IACjC,iFAAiF;IACjF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAOD,MAAM,MAAM,uBAAuB,GAAG,MAAM,yBAAyB,CAAC;AAEtE,KAAK,wBAAwB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,IAAI,0BAA0B,CAAC;IACvC,eAAe,IAAI,QAAQ,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChE,kBAAkB,IAAI,OAAO,CAAC;IAC9B,oBAAoB,IAAI,OAAO,CAAC;IAChC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,MAAM,CACJ,KAAK,EAAE,OAAO,CAAC,yBAAyB,CAAC,EACzC,GAAG,EAAE,gBAAgB,GACpB,wBAAwB,CAAC;IAC5B,KAAK,CACH,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,gBAAgB,GACpB,wBAAwB,CAAC;CAC7B;AA0FD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,IAAI,GAAG,kBAAkB,CA6FpG"}

package/dist/app/steps/extract.d.ts

@@ -16,6 +16,50 @@
  * `extractionCacheMissReason` captures *why* the cache could not be used so
  * the metrics dashboard can show the hit-rate alongside the failure mode.
  */
-import type { TieredRc, ExtractedRc } from "../run-context.ts";
+import type { TieredRc, ExtractedRc, WindowedRc } from "../run-context.ts";
+import type { PreparedConversationBackup, StructuredExtraction, CachedExtraction, LlmMessage, ProfileConfig } from "../../types.ts";
+/** Shared continuity input; previews must request a read-only state load. */
+export declare function loadExtractionContinuity(rc: {
+    cwd: string;
+    branch: unknown[];
+    sessionId: string;
+    llmMessages: LlmMessage[];
+}, extraction: StructuredExtraction, options?: {
+    readOnly?: boolean;
+}): {
+    projectId: string;
+    fingerprint: import("../../utils/fingerprint.ts").ProjectFingerprint | null;
+    projectCtx: string;
+    continuityScope: {
+        schemaVersion: 2;
+        projectId: string;
+        sessionId: string;
+        branchHeadId?: string | undefined;
+        branchAncestryIds?: string[] | undefined;
+    };
+    previousState: import("../../types.ts").CompactionState | null;
+    factOverrides: import("../../types.ts").ContinuityOverride[];
+    continuity: string;
+};
+/** Pure cache selection, including branch/content validation and delta extraction. */
+export declare function selectCachedExtraction(input: {
+    llmMessages: LlmMessage[];
+    profileCfg: ProfileConfig;
+    currentEntryIds: string[];
+    currentKeptEntryIds: string[];
+    cachedExt: CachedExtraction | null;
+}): {
+    extraction: StructuredExtraction;
+    cache: "exact" | "incremental" | "miss";
+    missReason?: string;
+};
+/**
+ * Deferred conversation backup of the compacted messages, shared by the EESV
+ * and native engines. Nothing is serialized until Pi confirms compaction;
+ * structured redaction and the text scrubber run before serialization, and
+ * redactions are surfaced because a restore brings back the redacted text.
+ * `scrubbedText` reuses an already scrubbed serialization of `messages`.
+ */
+export declare function prepareScrubbedBackup(rc: Pick<WindowedRc, "config" | "services" | "notify" | "sessionId" | "branch" | "totalTokens">, messages: LlmMessage[], scrubbedText?: string): PreparedConversationBackup | undefined;
 export declare function extractWithCache(rc: TieredRc): ExtractedRc;
 //# sourceMappingURL=extract.d.ts.map

package/dist/app/steps/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/app/steps/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA2C/D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,CA0U1D"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/app/steps/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,KAAK,EACX,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,MAAM,gBAAgB,CAAC;AAqCxB,6EAA6E;AAC7E,wBAAgB,wBAAwB,CACvC,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,EACpF,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;uBAOpB,CAAC;;;;;;;;;EAajB;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC;IACrD,eAAe,EAAE,MAAM,EAAE,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC7F,GAAG;IAAE,UAAU,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CA8CrG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC,EAC/F,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,CAAC,EAAE,MAAM,GACnB,0BAA0B,GAAG,SAAS,CAwBxC;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,CAwI1D"}

package/dist/app/steps/metrics.d.ts

@@ -16,6 +16,7 @@
  */
 import type { RcBase, StatedRc } from "../run-context.ts";
 import type { CompactionMode, MetricsSnapshot } from "../../types.ts";
+export declare function runType(rc: Pick<RcBase, "flags">): "manual" | "auto" | "tool";
 export declare function buildSuccessMetrics(rc: StatedRc, status: "success" | "dry-run" | "cancelled"): MetricsSnapshot;
 export declare function recordSuccessMetrics(rc: StatedRc, status: "success" | "dry-run" | "cancelled"): Promise<void>;
 /**

package/dist/app/steps/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/app/steps/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAGhB,MAAM,gBAAgB,CAAC;AA2DxB,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAC1C,eAAe,CAsEjB;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAC1C,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,GAAG,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA+Gf"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/app/steps/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACX,cAAc,EACd,eAAe,EAGf,MAAM,gBAAgB,CAAC;AA4BxB,wBAAgB,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAM7E;AAyBD,wBAAgB,mBAAmB,CAClC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GACzC,eAAe,CAwEjB;AAED,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GACzC,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,CAAC;CACtB;AAED,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,MAAM,GAAG,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA+Gf"}

package/dist/app/steps/persist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/app/steps/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,gBAAgB,CAAC;AAcxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AASlD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BnB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CA0CvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,UAAU,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,iBAAiB,CAyBnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CA2BlD"}
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/app/steps/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,gBAAgB,CAAC;AAexB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAWlD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BnB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CA0CvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,UAAU,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,iBAAiB,CA2BnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CA2BlD"}

package/dist/app/steps/prepare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/app/steps/prepare.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAgB,MAAM,mBAAmB,CAAC;AAW1E,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgFhE"}
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/app/steps/prepare.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAgB,MAAM,mBAAmB,CAAC;AAY1E,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkFhE"}

package/dist/app/steps/recover.d.ts

@@ -9,5 +9,14 @@
  * messages — the summary still beats no summary at all.
  */
 import type { WindowedRc, RecoveredRc } from "../run-context.ts";
+import type { LlmMessage } from "../../types.ts";
+/** Read-only source recovery shared by preflight and execution. */
+export declare function recoverSourceMessages(sessionId: string, entries: WindowedRc["toCompact"], cwd: string): Promise<{
+    messages: Array<{
+        entryId: string;
+        message: LlmMessage;
+    }>;
+    fromLog: boolean;
+}>;
 export declare function recoverSessionLog(rc: WindowedRc): Promise<RecoveredRc>;
 //# sourceMappingURL=recover.d.ts.map

package/dist/app/steps/recover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/app/steps/recover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOjE,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAuB5E"}
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/app/steps/recover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,mEAAmE;AACnE,wBAAsB,qBAAqB,CAC1C,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,GAC9D,OAAO,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAY1F;AAED,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAY5E"}

package/dist/app/steps/synthesize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/app/steps/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA0BH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUpE,wBAAsB,qBAAqB,CAC1C,EAAE,EAAE,WAAW,GACb,OAAO,CAAC,aAAa,CAAC,CA+lBxB"}
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/app/steps/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA4BH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAYpE,wBAAsB,qBAAqB,CAC1C,EAAE,EAAE,WAAW,GACb,OAAO,CAAC,aAAa,CAAC,CA8lBxB"}

package/dist/app/steps/tier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../../src/app/steps/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAc,MAAM,mBAAmB,CAAC;AAQ3E,wBAAgB,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,CA+B3D"}
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../../src/app/steps/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAc,MAAM,mBAAmB,CAAC;AAS3E,wBAAgB,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,CA8B3D"}

package/dist/app/steps/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/app/steps/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiBnE,wBAAsB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAmN3E"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/app/steps/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiBnE,wBAAsB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAoN3E"}

package/dist/app/steps/visual.d.ts

@@ -0,0 +1,4 @@
+import { renderVisualPages } from "../../infra/visual-renderer.ts";
+import type { StatedRc } from "../run-context.ts";
+export declare function attachVisualArchive(rc: StatedRc, render?: typeof renderVisualPages): Promise<void>;
+//# sourceMappingURL=visual.d.ts.map

package/dist/app/steps/visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../../../src/app/steps/visual.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,iBAAiB,EAAkB,MAAM,gCAAgC,CAAC;AAGzG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,2BAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CjG"}

package/dist/app/steps/window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../src/app/steps/window.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EAEV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,uBAAuB,EAEvB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAexB,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIhF,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,+DAA+D;AAC/D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAe7E;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,aAAa,EACzB,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,oBAAoB,GAAG,SAAS,GAC7C,MAAM,CAkBR;AAyDD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,oBAAoB,CA0LtB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAqGzE"}
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../src/app/steps/window.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAI1E,OAAO,KAAK,EACX,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EAEV,UAAU,EACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACX,uBAAuB,EAEvB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,MAAM,gBAAgB,CAAC;AAexB,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIhF,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,+DAA+D;AAC/D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAe7E;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC5C,UAAU,EAAE,aAAa,EACzB,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,oBAAoB,GAAG,SAAS,GAC5C,MAAM,CAkBR;AAyDD,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,yBAAyB,GAC9B,oBAAoB,CA0LtB;AA8BD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAqGzE"}

package/dist/app/tool-artifacts.d.ts

@@ -0,0 +1,27 @@
+import type { ExtensionAPI, SessionEntry } from "@earendil-works/pi-coding-agent";
+import type { CompactConfig } from "../types.ts";
+export declare const ARTIFACT_DETAILS_KEY = "smartCompactArtifact";
+export declare const ARTIFACT_MIN_CHARS = 16384;
+export declare const ARTIFACT_MAX_BYTES: number;
+export declare const ARTIFACT_SESSION_BYTES: number;
+export declare const ARTIFACT_SESSION_FILES = 256;
+export declare const digest: (text: string) => string;
+export interface ToolArtifact {
+    version: 1;
+    owner: string;
+    hash: string;
+    previewHash: string;
+    chars: number;
+    bytes: number;
+    lines: number;
+    tool: string;
+    source: string;
+}
+export declare const artifactId: (artifact: ToolArtifact) => string;
+export declare function parseToolArtifact(value: unknown): ToolArtifact | null;
+/** Caller must first prove the reference is reachable from its active branch. */
+export declare function readToolArtifact(artifact: ToolArtifact): Promise<string>;
+/** `retrievable` answers whether the agent can reach `smart_context` to read an offloaded output back. */
+export declare function registerArtifactOffload(pi: ExtensionAPI, config: () => CompactConfig, retrievable: () => boolean): void;
+export declare function branchToolArtifacts(branch: readonly SessionEntry[], ownedReferences: ReadonlySet<string>): Map<string, ToolArtifact>;
+//# sourceMappingURL=tool-artifacts.d.ts.map

package/dist/app/tool-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-artifacts.d.ts","sourceRoot":"","sources":["../../src/app/tool-artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAmB,MAAM,iCAAiC,CAAC;AAKnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAClD,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AACvD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,eAAO,MAAM,MAAM,SAAU,MAAM,WAAoD,CAAC;AAExF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,eAAO,MAAM,UAAU,aAAc,YAAY,WAAgC,CAAC;AAElF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAOrE;AAiBD,iFAAiF;AACjF,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB9E;AA6CD,0GAA0G;AAC1G,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,GAAG,IAAI,CA2CvH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,6BAcxG"}

package/dist/app/visual-archive.d.ts

@@ -0,0 +1,29 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { type ContextEvent, type ExtensionContext, type SessionEntry } from "@earendil-works/pi-coding-agent";
+import { SecretScrubber } from "../domain/scrub.ts";
+import type { SessionMessageEntry, VisualArchive } from "../types.ts";
+export declare const VISUAL_CONTEXT_TYPE = "smart-compact-visual-evidence";
+export declare const VISUAL_MAX_SOURCE_CHARS = 24000;
+export declare function canReadVisual(model: Pick<Model<Api>, "input" | "api"> | undefined): boolean;
+/** Planning only, not billed savings. Expand supported models after validating their image rules. */
+export declare function visualEconomics(reader: VisualArchive["reader"], sources: VisualArchive["sources"], frames: Array<{
+    width: number;
+    height: number;
+}>, estimateText?: (text: string) => number): {
+    textTokens: number;
+    imageTokens: number | null;
+    worthwhile: boolean;
+};
+export declare function visualSourceLines(source: VisualArchive["sources"][number]): string[];
+export declare function visualPages(sources: VisualArchive["sources"]): string[][];
+/** Validate persisted data before it can become model input or a retrieval result. */
+export declare function validVisualArchive(value: unknown): value is VisualArchive;
+export declare function activeVisualArchive(branch: readonly SessionEntry[]): {
+    entry: import("@earendil-works/pi-coding-agent").CompactionEntry<unknown>;
+    archive: VisualArchive;
+} | null;
+/** Prefer recent evidence; carry bounded source text across generations without OCR. */
+export declare function selectVisualSources(branch: SessionEntry[], toCompact: SessionMessageEntry[], summary: string, scrubber: SecretScrubber): VisualArchive["sources"];
+/** Append image evidence beside, not instead of, the exact summary in this request. */
+export declare function injectVisualArchive(messages: ContextEvent["messages"], branch: SessionEntry[], ctx: Pick<ExtensionContext, "model" | "getContextUsage">, enabled: boolean, scrubber?: SecretScrubber): ContextEvent["messages"];
+//# sourceMappingURL=visual-archive.d.ts.map

package/dist/app/visual-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-archive.d.ts","sourceRoot":"","sources":["../../src/app/visual-archive.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAkB,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC9H,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMtE,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AACnE,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAM9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,SAAS,GAAG,OAAO,CAG3F;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,EAChG,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,YAAY,UAAU,MAAM,WAAyD;;;;EAUxI;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAQpF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,EAAE,CAKzE;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAgCzE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE;;;SAUlE;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,aAAa,CAAC,SAAS,CAAC,CAiCjK;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,iBAAuB,GAAG,YAAY,CAAC,UAAU,CAAC,CAuBrO"}

package/dist/constants.d.ts

@@ -8,7 +8,29 @@ import type { CompressionProfile, ProfileConfig } from "./types.ts";
  * `package.json#version`. Do not hand-edit this line for releases; bump
  * package.json and run `bun run sync-version`.
  */
-export declare const VERSION = "9.7.1";
+export declare const VERSION = "10.0.1";
+/**
+ * Opt-in components that are not installed with the extension: optional peer
+ * dependencies in package.json, pinned to the versions the release audit
+ * exercises. The audit fails if these drift from the manifest.
+ */
+export declare const OPTIONAL_COMPONENTS: {
+    readonly mnemopi: {
+        readonly name: "@oh-my-pi/pi-mnemopi";
+        readonly version: "18.3.1";
+        readonly enables: "Mnemopi memory store";
+    };
+    readonly bun: {
+        readonly name: "bun";
+        readonly version: "1.4.2";
+        readonly enables: "Mnemopi worker runtime when no Bun 1.3.14+ is on PATH";
+    };
+    readonly resvg: {
+        readonly name: "@resvg/resvg-js";
+        readonly version: "2.6.2";
+        readonly enables: "image snapshots";
+    };
+};
 export declare const CHARS_PER_TOKEN = 3.8;
 export declare const MIN_COMPACTION_SAVING_RATIO = 0.1;
 export declare const ESTIMATOR_ROUNDING_TOLERANCE_TOKENS = 1;
@@ -22,6 +44,24 @@ export declare const AUTO_TRIGGER_TIMEOUT_CAP_MS = 60000;
 export declare const AUTO_TRIGGER_MAX_LLM_CALLS = 4;
 /** Suppress proactive settled-trigger churn after any confirmed compaction. */
 export declare const SETTLED_TRIGGER_COOLDOWN_MS: number;
+/**
+ * Minimum uncached prompt tokens (input + cacheWrite) for a host request to
+ * count as a prompt-cache rebuild. Anthropic caches need >=1024-4096-token
+ * prefixes and every turn legitimately re-sends the new tail uncached (tool
+ * results, user input: routinely a few thousand tokens); 16k sits clearly
+ * above that tail noise while staying far below a real prefix rebuild.
+ */
+export declare const REBUILD_MIN_TOKENS = 16384;
+/**
+ * Further requests within which a warm-cache automatic trim must pay back its
+ * prefix rewrite; sessions rarely run that many requests without another prefix change.
+ */
+export declare const AUTO_TRIM_BREAK_EVEN_REQUESTS = 24;
+/**
+ * Expected savings (USD) a prompt-cache refresh must reach to be worth sending;
+ * Pi warms when `continuationProbability * missCost - warmCost >= 0.05` (Pi docs/settings.md).
+ */
+export declare const CACHE_WARMING_MIN_SAVINGS_USD = 0.05;
 /** Positive per-run bounds shared by CLI and tool arguments; config separately allows 0 as a mode-derived sentinel. */
 export declare const BUDGET_LIMITS: {
     readonly CALLS: {
@@ -47,12 +87,19 @@ export declare const PROFILE_NUMERIC_BOUNDS: {
     readonly singlePassMaxTokens: readonly [1000, 500000];
     readonly batchMaxTokens: readonly [1000, 500000];
 };
+/** Home warns above this model window when maxContextTokens is off. */
+export declare const LARGE_CONTEXT_WINDOW_TOKENS = 400000;
 export declare const CONFIG_NUMERIC_LIMITS: {
     readonly minContextPercent: {
         readonly min: 0;
         readonly max: 100;
         readonly integer: false;
     };
+    readonly prepareContextPercent: {
+        readonly min: 0;
+        readonly max: 100;
+        readonly integer: false;
+    };
     readonly autoTriggerTimeoutMs: {
         readonly min: 1000;
         readonly max: 300000;
@@ -68,6 +115,12 @@ export declare const CONFIG_NUMERIC_LIMITS: {
         readonly max: 1000000;
         readonly integer: true;
     };
+    readonly maxContextTokens: {
+        readonly min: 16384;
+        readonly max: 2000000;
+        readonly integer: true;
+        readonly zeroOrRange: true;
+    };
     readonly codexMaxCallMs: {
         readonly min: 5000;
         readonly max: 3600000;
@@ -85,6 +138,16 @@ export declare const CONFIG_NUMERIC_LIMITS: {
         readonly max: 3600000;
         readonly integer: true;
     };
+    readonly hindsightTimeoutMs: {
+        readonly min: 1000;
+        readonly max: 60000;
+        readonly integer: true;
+    };
+    readonly hindsightRecallMaxTokens: {
+        readonly min: 128;
+        readonly max: 4096;
+        readonly integer: true;
+    };
 };
 export declare const DEFAULT_CONFIG: {
     mode: "auto";
@@ -96,6 +159,7 @@ export declare const DEFAULT_CONFIG: {
     summaryThinkingLevel: "minimal";
     segmentationThinkingLevel: "minimal";
     agentToolAccess: "inherit";
+    toolLoading: "lazy";
     autoTrigger: boolean;
     showStatus: boolean;
     autoTriggerStrategy: "native-hook";
@@ -103,6 +167,8 @@ export declare const DEFAULT_CONFIG: {
     backupEnabled: boolean;
     backupDir: string;
     minContextPercent: number;
+    prepareContextPercent: number | null;
+    maxContextTokens: number;
     requireApproval: boolean;
     scrubSecrets: boolean;
     scrubPii: boolean;
@@ -114,6 +180,23 @@ export declare const DEFAULT_CONFIG: {
     focusWeighting: boolean;
     zeroCallEnabled: boolean;
     contextGraphEnabled: boolean;
+    compactionEngines: Array<"eesv" | "native">;
+    memoryBackend: "local";
+    hindsightBaseUrl: string | null;
+    hindsightBankId: string | null;
+    hindsightApiKeyEnv: string | null;
+    hindsightTimeoutMs: number;
+    hindsightRecallMaxTokens: number;
+    mnemopiDataDir: string | null;
+    visualArchiveEnabled: boolean;
+    artifactOffloadEnabled: boolean;
+    contextHygieneEnabled: boolean;
+    contextNavigationEnabled: boolean;
+    contextRecallEnabled: boolean;
+    contextPivotEnabled: boolean;
+    contextAnchorCacheEnabled: boolean;
+    contextAnchorStatusEnabled: boolean;
+    contextGuidanceEnabled: boolean;
     telemetryChannel: "stable";
     adaptiveDamageFeedback: boolean;
     onlineDamageMonitor: boolean;
@@ -217,10 +300,22 @@ export declare const MAX_TOOL_OUTPUT_CHARS = 800;
 export declare const MAX_EXPLORER_OUTPUT_CHARS = 12000;
 /** Shell-output patterns signalling a likely error even in a non-`isError` result. */
 export declare const LIKELY_ERROR_RE: RegExp;
+/** Conservative risk lines kept in a trim marker's digest (errors, failures, warnings, exits). */
+export declare const TRIM_RISK_LINE_RE: RegExp;
+/** Trim marker digest bounds: line 1 always kept; later lines dropped from the end to fit. */
+export declare const TRIM_MARKER_MAX_LINES = 6;
+export declare const TRIM_MARKER_MAX_CHARS = 400;
 /** How far forward to look for a retry of the same tool after an error. */
 export declare const ERROR_RETRY_WINDOW = 6;
 /** How far forward to look for that retry's resolving (non-error) result. */
 export declare const ERROR_RESOLVE_WINDOW = 10;
+/** Handoff seed cap (same as a pivot carryover); recall gets a bounded share. */
+export declare const HANDOFF_MAX_CHARS = 16000;
+export declare const HANDOFF_RECALL_MAX_CHARS = 6000;
+export declare const HANDOFF_RECALL_LIMIT = 5;
+/** Parent sessions `smart_context scope=lineage` follows through `parentSession` headers, and the largest file it loads. */
+export declare const LINEAGE_MAX_DEPTH = 3;
+export declare const LINEAGE_MAX_FILE_BYTES: number;
 export declare const METRICS_BUFFER_MAX = 200;
 export declare const RUNTIME_LOG_MAX_BYTES: number;
 export declare const CONFIG_KEY = "smartCompact";

package/dist/constants.d.ts.map

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

package/dist/domain/compaction-usage.d.ts

@@ -0,0 +1,16 @@
+import type { Api, Model, Usage } from "@earendil-works/pi-ai";
+import type { MetricsSnapshot } from "../types.ts";
+export type RouteModelResolver = (provider: string, model: string) => Model<Api> | undefined;
+/**
+ * Provider-reported usage of one compaction run in Pi's `Usage` shape, so a
+ * `session_before_compact` result can carry it into Pi's session totals.
+ *
+ * Tokens come from the run's per-route metrics (or the run totals when no
+ * route rows exist). Cost uses the catalog rates of each route's model, the
+ * way Pi prices its own requests; an unresolvable model contributes tokens
+ * but no cost. Returns undefined when the run made no provider call or when
+ * any route's usage was estimated rather than reported: Pi's totals must not
+ * mix local estimates with provider counts.
+ */
+export declare function compactionUsage(snapshot: Pick<MetricsSnapshot, "totalCalls" | "totalInput" | "totalOutput" | "totalCacheHit" | "totalCacheWrite" | "providerRoutes" | "provider" | "model">, resolveModel: RouteModelResolver): Usage | undefined;
+//# sourceMappingURL=compaction-usage.d.ts.map

package/dist/domain/compaction-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-usage.d.ts","sourceRoot":"","sources":["../../src/domain/compaction-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAQ7F;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,YAAY,GAAG,aAAa,GAAG,eAAe,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAC,EAC5J,YAAY,EAAE,kBAAkB,GAC9B,KAAK,GAAG,SAAS,CA2BnB"}

package/dist/domain/model-capacity.d.ts

@@ -0,0 +1,12 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { LLMCallMetric } from "../types.ts";
+type CapacityModel = Pick<Model<Api>, "provider" | "id" | "contextWindow" | "maxTokens">;
+export declare function clampCompletionMaxTokens(model: CapacityModel, requested: number | undefined): number | undefined;
+/** Local estimate, not a provider tokenizer guarantee. Applied again to each built request. */
+export declare function modelRequestCapacityReason(model: CapacityModel, estimatedInputTokens: number, requestedOutputTokens: number | undefined): string | undefined;
+export declare class ModelCapacityError extends Error {
+    readonly phase: LLMCallMetric["phase"];
+    constructor(phase: LLMCallMetric["phase"], reason: string);
+}
+export {};
+//# sourceMappingURL=model-capacity.d.ts.map

package/dist/domain/model-capacity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-capacity.d.ts","sourceRoot":"","sources":["../../src/domain/model-capacity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,eAAe,GAAG,WAAW,CAAC,CAAC;AAMzF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAMpB;AAED,+FAA+F;AAC/F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,oBAAoB,EAAE,MAAM,EAC5B,qBAAqB,EAAE,MAAM,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CAapB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC;IAAlD,YAAqB,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAGjE;CACF"}

package/dist/domain/provider-evaluation.d.ts

@@ -9,12 +9,19 @@ export interface ProviderEvaluationCell {
     calls: number;
     successRate: number;
     avgLatencyMs: number;
+    /** Quota-inclusive: input + cacheRead + cacheWrite + output per call. */
     avgTokensPerCall: number;
+    avgCacheReadTokensPerCall: number;
+    avgCacheWriteTokensPerCall: number;
     avgQuality: number | null;
     qualityCoverage: number;
     score: number;
     confidence: number;
     eligible: boolean;
+    /** Present when any contributing run used estimated usage. */
+    usageBasis?: "reported" | "estimated";
+    /** Subscription (OAuth) rows must never be priced at API rates. */
+    billing?: "api" | "subscription";
 }
 export interface ProviderRouteRecommendation {
     stage: ProviderRouteStage;

package/dist/domain/provider-evaluation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-evaluation.d.ts","sourceRoot":"","sources":["../../src/domain/provider-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAC5E,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GAAG,eAAe,GAAG,oBAAoB,GACjE,yBAAyB,GAAG,gBAAgB,GAAG,qBAAqB,GACpE,yBAAyB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,eAAe,EAAE,2BAA2B,EAAE,CAAC;CAChD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAI/E;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,mBAAmB,EAAE,CAkChG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,aAAa,CAAC,GAAG,gBAAgB,CAMrH;AAsDD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,wBAAwB,CAiG1B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAoBjF"}
+{"version":3,"file":"provider-evaluation.d.ts","sourceRoot":"","sources":["../../src/domain/provider-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAC5E,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GAAG,eAAe,GAAG,oBAAoB,GACjE,yBAAyB,GAAG,gBAAgB,GAAG,qBAAqB,GACpE,yBAAyB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,EAAE,MAAM,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,mEAAmE;IACnE,OAAO,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,eAAe,EAAE,2BAA2B,EAAE,CAAC;CAChD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAI/E;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,mBAAmB,EAAE,CAsDhG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,aAAa,CAAC,GAAG,gBAAgB,CAMrH;AAgED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,wBAAwB,CA6G1B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAwBjF"}

package/dist/domain/telemetry.d.ts

@@ -1,4 +1,4 @@
-import type { CompactMetricsEntry, TelemetryFailureKind } from "../types.ts";
+import type { CompactMetricsEntry, PreparationDiscardReason, TelemetryFailureKind } from "../types.ts";
 export interface DamageTelemetryEntry {
     ts?: string;
     /** Originating compaction run; required for trustworthy quality/damage joins. */
@@ -10,7 +10,10 @@ export interface DamageTelemetryEntry {
 }
 export interface TelemetryWindowStats {
     runs: number;
+    /** Host-confirmed applies only (status success). */
     appliedRuns: number;
+    /** Real non-dry, non-cancel attempts backing the failure-rate signal. */
+    attemptedRuns: number;
     successRate: number;
     avgQuality: number | null;
     qualityCoverage: number;
@@ -37,22 +40,58 @@ export interface CanaryAssessment {
 }
 export interface PrivacySafeTelemetryAggregate {
     version: string;
-    channel: "stable" | "canary";
+    /** "unknown" when an entry carries no explicit channel; never silently stable. */
+    channel: "stable" | "canary" | "unknown";
     provider: string;
     model: string;
     runs: number;
+    /** Host-confirmed applies only. */
     successes: number;
     avgQuality: number | null;
     avgLatencyMs: number;
     inputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
     outputTokens: number;
 }
+/** Content-free policy measurements for speculative preparation. */
+export interface PreparationPolicyStats {
+    preparedRuns: number;
+    usedRuns: number;
+    discardedRuns: number;
+    /** Prepared runs that ended in timeout/error — real failures, not discards. */
+    otherOutcomes: number;
+    discardReasons: Partial<Record<PreparationDiscardReason, number>>;
+    medianReadyMs: number | null;
+    medianWaitMs: number | null;
+    /** used / (used + discarded); null before the first resolvable outcome. */
+    reuseRate: number | null;
+    /** Spend on work that never applied; counted once, never in the applied cohort. */
+    discardedCost: {
+        calls: number;
+        inputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        outputTokens: number;
+    };
+}
+/** Aggregate visibility for existing verifier-provenance fields. */
+export interface QualityProvenanceStats {
+    measuredRuns: number;
+    avgInitialQuality: number | null;
+    avgRepairGain: number | null;
+    deterministicPatchRuns: number;
+    llmPatchRuns: number;
+    qualityFloorRuns: number;
+}
 export interface PrivacySafeTelemetry {
     generatedAt: string;
     totalRuns: number;
     aggregates: PrivacySafeTelemetryAggregate[];
     failures: Partial<Record<TelemetryFailureKind, number>>;
     canary: CanaryAssessment;
+    preparation: PreparationPolicyStats;
+    qualityProvenance: QualityProvenanceStats;
     privacy: "aggregate-only; no session ids, project ids, prompts, summaries, paths, or error text";
 }
 /** Stable, content-free failure taxonomy for aggregate telemetry. */
@@ -64,6 +103,8 @@ export declare function assessCanary(entries: readonly CompactMetricsEntry[], da
 }): CanaryAssessment;
 export declare const TELEMETRY_FAILURE_KINDS: ReadonlySet<TelemetryFailureKind>;
 export declare function isTelemetryFailureKind(value: unknown): value is TelemetryFailureKind;
+export declare function buildPreparationStats(entries: readonly CompactMetricsEntry[]): PreparationPolicyStats;
+export declare function buildQualityProvenanceStats(entries: readonly CompactMetricsEntry[]): QualityProvenanceStats;
 export declare function buildPrivacySafeTelemetry(entries: readonly CompactMetricsEntry[], damageEntries: readonly DamageTelemetryEntry[], options: {
     version: string;
     minCanaryRuns?: number;