@lexwdex-org/opencode-dcp 3.4.14 → 3.5.0

package/dist/lib/auto-prune.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-prune.d.ts","sourceRoot":"","sources":["../../lib/auto-prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAA;CACzB;AAUD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAiBlD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAO9D;AAwBD,qBAAa,UAAU;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAGb,MAAM,EAAE,eAAe,EACxC,GAAG,CAAC,EAAE,MAAM,MAAM;IAKtB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,SAAa,GAAG,aAAa;IAoBvF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,WAAW,EAAE,GAAG,IAAI;IAUxE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,IAAI;IASpD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpC,OAAO,CAAC,QAAQ;IA6BhB,OAAO,CAAC,KAAK;CAYhB"}
+{"version":3,"file":"auto-prune.d.ts","sourceRoot":"","sources":["../../lib/auto-prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAA;CACzB;AAUD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAiBlD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAO9D;AAwBD,qBAAa,UAAU;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAGb,MAAM,EAAE,eAAe,EACxC,GAAG,CAAC,EAAE,MAAM,MAAM;IAKtB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,SAAa,GAAG,aAAa;IAoBvF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,WAAW,EAAE,GAAG,IAAI;IAUxE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,IAAI;IASpD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpC,OAAO,CAAC,QAAQ;IA8BhB,OAAO,CAAC,KAAK;CAYhB"}

package/dist/lib/config.d.ts

@@ -8,8 +8,15 @@ export interface ExperimentalConfig {
 export interface SummarizeConfig {
     failureCooldownMs: number;
 }
+export interface AutoPruneSignals {
+    topicDrift: boolean;
+    volume: boolean;
+    idleGap: boolean;
+}
 export interface AutoPruneConfig {
     enabled: boolean;
+    /** Per-signal switches; only topic changes are enabled by default (LD1). */
+    signals: AutoPruneSignals;
     minMessages: number;
     volumeThreshold: number;
     driftThreshold: number;
@@ -42,6 +49,13 @@ interface ValidationError {
     actual: string;
 }
 export declare function validateConfigTypes(config: Record<string, any>): ValidationError[];
+/**
+ * SR1 migration hint condition: auto prune is on but the user config predates
+ * the per-signal switches. The hint fires on every config load where this
+ * holds (same always-fires, stateless mechanism as the compress.* hints — no
+ * persistent "one-time" flag).
+ */
+export declare function needsSignalsMigrationHint(configData: Record<string, any>): boolean;
 export declare function getConfig(ctx: PluginInput): PluginConfig;
 export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,iBAAiB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA;AAErC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,WAAW,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,SAAS,EAAE,eAAe,CAAA;IAC1B,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACnB;AAID,eAAO,MAAM,kBAAkB,EAAE,eAOhC,CAAA;AAED,eAAO,MAAM,iBAAiB,aAqB5B,CAAA;AAKF,eAAO,MAAM,sBAAsB,aA0CjC,CAAA;AAeF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAEjF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAI9E;AAED,UAAU,eAAe;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,EAAE,CAuJlF;AA2SD,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAsCxD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,iBAAiB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,OAAO,EAAE,gBAAgB,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA;AAErC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,WAAW,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,SAAS,EAAE,eAAe,CAAA;IAC1B,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACnB;AAID,eAAO,MAAM,kBAAkB,EAAE,eAQhC,CAAA;AAED,eAAO,MAAM,iBAAiB,aAyB5B,CAAA;AAKF,eAAO,MAAM,sBAAsB,aA0CjC,CAAA;AAeF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAEjF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAI9E;AAED,UAAU,eAAe;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,EAAE,CA4KlF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CASlF;AA2UD,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAsCxD"}

package/dist/lib/hooks.d.ts

@@ -4,6 +4,7 @@ import type { OpenCodeClient } from "./opencode-client";
 import type { PromptStore } from "./prompts/store";
 import type { AutoPruner } from "./auto-prune";
 import type { PruneService } from "./prune-service";
+import type { RestFireReason } from "./session-boundary";
 interface CompactionOutput {
     context: string[];
     prompt?: string;
@@ -15,18 +16,36 @@ export declare function createChatMessageHandler(autoPruner: AutoPruner): (input
     sessionID: string;
 }, _output?: unknown) => Promise<void>;
 export interface EventHandlerDeps {
-    client: OpenCodeClient;
     prune: PruneService;
     autoPruner: AutoPruner;
-    config: AutoPruneConfig;
     logger: Logger;
 }
+/**
+ * Every host event feeds the PruneService first: `session.status` / legacy
+ * `session.idle` observations go to the boundary tracker, which classifies
+ * at-rest boundaries (quiet window + live probe) and drives both the
+ * deferred-prune drain and the at-rest auto-prune listener. This handler only
+ * keeps the heuristic pruner's own lifecycle state in sync.
+ */
 export declare function createEventHandler(deps: EventHandlerDeps): (input: {
     event: {
         type: string;
         properties?: Record<string, any>;
     };
 }) => Promise<void>;
+export interface AtRestAutoPruneDeps {
+    client: OpenCodeClient;
+    prune: PruneService;
+    autoPruner: AutoPruner;
+    config: AutoPruneConfig;
+    logger: Logger;
+}
+/**
+ * At-rest listener #2: the heuristic auto prune. The `enabled` gate stays at
+ * this mount point — a tool-only configuration (auto prune disabled) never
+ * registers the listener, so it gains no auto-prune behavior.
+ */
+export declare function createAtRestAutoPruneListener(deps: AtRestAutoPruneDeps): (sessionID: string, _reason: RestFireReason) => Promise<void>;
 export declare function createCommandExecuteHandler(client: OpenCodeClient, prune: PruneService, logger: Logger): (input: {
     command: string;
     sessionID: string;

package/dist/lib/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnE,UAAU,gBAAgB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IACjE,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAiBvF;AAeD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,IAC7C,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAQD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IAiDvC,OAAO;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,mBAiCrF;AAED,wBAAgB,2BAA2B,CACvC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,IAGV,OAAO;IACH,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB,EACD,UAAU;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAC/B,OAAO,CAAC,IAAI,CAAC,CAuDnB"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,UAAU,gBAAgB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IACjE,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAiBvF;AAeD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,IAC7C,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAQD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IACvC,OAAO;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,mBAoBrF;AAoDD,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,mBAAmB,IACrD,WAAW,MAAM,EAAE,SAAS,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAK3E;AAED,wBAAgB,2BAA2B,CACvC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,IAGV,OAAO;IACH,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB,EACD,UAAU;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAC/B,OAAO,CAAC,IAAI,CAAC,CAuDnB"}

package/dist/lib/prune-service.d.ts

@@ -1,15 +1,16 @@
-import type { SessionActivityTracker } from "./activity";
 import type { Logger } from "./logger";
 import type { OpenCodeClient } from "./opencode-client";
+import { SessionBoundaryTracker } from "./session-boundary";
 import type { SummarizeCoordinator } from "./summarize";
+export { eventSessionID, retrySeconds } from "./session-boundary";
 /**
  * How a trigger surface wants the service to react when the session is (or may
  * be) mid-turn:
  * - `"defer"`: compaction must never interrupt a running turn. Queue the prune
- *   and execute it at the next observed turn boundary. Used by the
+ *   and execute it at the next confirmed at-rest boundary. Used by the
  *   model-invokable tool, which by definition executes mid-turn.
  * - `"proceed"`: fire at turn boundaries anyway; only stand down on positive
- *   busy evidence. Used by idle-driven auto prune and the manual command.
+ *   busy evidence. Used by at-rest-driven auto prune and the manual command.
  */
 export type PruneBusyPolicy = "defer" | "proceed";
 export type PruneOutcome = {
@@ -34,25 +35,22 @@ export interface PruneRequest {
 export interface PruneServiceDeps {
     client: OpenCodeClient;
     summarize: SummarizeCoordinator;
-    activity: SessionActivityTracker;
     logger: Logger;
+    /** Injectable clock/timers (tests). BOUNDARY_QUIET_MS stays a code constant. */
+    now?: () => number;
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (t: unknown) => void;
+    /** Injectable probe deadline (tests only; defaults to PROBE_TIMEOUT_MS). */
+    probeTimeoutMs?: number;
 }
 /** Host event names this service derives safety decisions from. */
 export type PruneEventName = "session.idle" | "session.status" | "session.compacted" | "session.deleted" | (string & {});
-/** Ceil a cooldown to whole seconds for user-facing copy. */
-export declare function retrySeconds(retryAfterMs: number): number;
-/**
- * Resolves the session ID from a host event's properties. Most events carry
- * `sessionID` directly, but some (e.g. `session.deleted`) only carry
- * `info: Session`. Returns `undefined` when neither is a non-empty string.
- */
-export declare function eventSessionID(properties?: Record<string, any>): string | undefined;
 /**
  * The single compression entry point. Every trigger surface (model tool,
  * heuristic auto prune, manual command) goes through `request`; the service
  * owns everything a caller must not have to know: session busy state, the
- * never-interrupt-a-running-turn invariant, deferral to the next turn
- * boundary, session model resolution, and delegation to the native
+ * never-interrupt-a-running-turn invariant, deferral to the next confirmed
+ * at-rest boundary, session model resolution, and delegation to the native
  * summarize coordinator (single-flight + failure cooldown).
  *
  * `request` never rejects: every failure mode is a `PruneOutcome`.
@@ -61,26 +59,31 @@ export declare class PruneService {
     private readonly deferred;
     private readonly client;
     private readonly summarize;
-    private readonly activity;
     private readonly logger;
+    private readonly probeTimeoutMs;
+    /** THE single busy/idle event state machine (absorbed the former
+     * SessionActivityTracker — no second busy cache may exist). */
+    readonly boundary: SessionBoundaryTracker;
     constructor(deps: PruneServiceDeps);
     /**
-     * Feed every host event through here. Drains the deferral queue on
-     * `session.idle` and forgets queued prunes once a compaction (or the
-     * session itself) is gone.
+     * Feed every host event through here. `session.status` and legacy
+     * `session.idle` feed the boundary tracker (quiet window + expiry probe);
+     * the deferral queue drains at the confirmed at-rest classification, and
+     * queued prunes are forgotten once a compaction (or the session itself)
+     * is gone.
      */
     observeEvent(type: PruneEventName, properties?: Record<string, any>): void;
     request(request: PruneRequest): Promise<PruneOutcome>;
     /** One admission check; `null` means the request may proceed. */
     private gate;
     /**
-     * Executes a queued prune at the idle boundary. The tool already promised
-     * its caller this prune would run; losing the busy race must not silently
-     * break that promise, so a busy outcome re-queues for the next idle
-     * boundary. Every other outcome is terminal: it is logged and never
-     * retried — new prune demand arrives through new triggers only.
-     * Execution is re-guarded on every attempt, so re-queueing never violates
-     * the never-interrupt invariant.
+     * Executes a queued prune at the confirmed at-rest boundary. The tool
+     * already promised its caller this prune would run; losing the busy race
+     * must not silently break that promise, so a busy outcome re-queues for
+     * the next at-rest boundary. Every other outcome is terminal: it is
+     * logged and never retried — new prune demand arrives through new
+     * triggers only. Execution is re-guarded on every attempt, so re-queueing
+     * never violates the never-interrupt invariant.
      */
     private drainQueued;
     /**
@@ -90,10 +93,12 @@ export declare class PruneService {
     private outcomeFor;
     private admit;
     /**
-     * Queries the host's live session status. Returns `null` when the answer
-     * is unknown (endpoint or SDK method missing, request failed) — callers
-     * must fail open in that case.
+     * THE single live busy probe, reused verbatim by the boundary tracker's
+     * expiry check. Bounded by a finite deadline: a never-returning probe
+     * resolves `null` within the timeout (fail-open). Returns `null` when the
+     * answer is unknown (endpoint or SDK method missing, request failed,
+     * timeout) — callers must fail open in that case.
      */
-    private isBusyOnServer;
+    probeBusy(sessionID: string): Promise<boolean | null>;
 }
 //# sourceMappingURL=prune-service.d.ts.map

package/dist/lib/prune-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prune-service.d.ts","sourceRoot":"","sources":["../../lib/prune-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAA;AAEjD,MAAM,MAAM,YAAY,GAClB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzC,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,oBAAoB,CAAA;IAC/B,QAAQ,EAAE,sBAAsB,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;CACjB;AAID,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACpB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,GACjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,CAMnF;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,IAAI,EAAE,gBAAgB;IAOlC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAoBpE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAmC3D,iEAAiE;IACjE,OAAO,CAAC,IAAI;IAIZ;;;;;;;;OAQG;YACW,WAAW;IAqBzB;;;OAGG;YACW,UAAU;IAaxB,OAAO,CAAC,KAAK;IAUb;;;;OAIG;YACW,cAAc;CAe/B"}
+{"version":3,"file":"prune-service.d.ts","sourceRoot":"","sources":["../../lib/prune-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,EAEH,sBAAsB,EAGzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAA;AAEjD,MAAM,MAAM,YAAY,GAClB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzC,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,oBAAoB,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IAClD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACjC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AAID,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACpB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,GACjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC;mEAC+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;gBAE7B,IAAI,EAAE,gBAAgB;IAqBlC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAwBpE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAmC3D,iEAAiE;IACjE,OAAO,CAAC,IAAI;IAIZ;;;;;;;;OAQG;YACW,WAAW;IAqBzB;;;OAGG;YACW,UAAU;IAaxB,OAAO,CAAC,KAAK;IAUb;;;;;;OAMG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAqB9D"}

package/dist/lib/session-boundary.d.ts

@@ -0,0 +1,90 @@
+import type { Logger } from "./logger";
+/**
+ * Per-session boundary phase. The compression boundary is NOT the raw
+ * `session.idle` instant: an idle observation opens a quiet window, and only
+ * a window that survives its full duration plus a live status probe is
+ * classified as AT-REST. Busy/retry evidence at any point cancels the window.
+ */
+export type BoundaryPhase = "unknown" | "busy" | "pending-rest" | "at-rest";
+/** Why an at-rest classification fired. `probe-failopen` covers a missing
+ * endpoint, an HTTP error, and a timed-out probe — all fail open. */
+export type RestFireReason = "window-expired" | "probe-failopen";
+export type AtRestListener = (sessionID: string, reason: RestFireReason) => void | Promise<void>;
+/** Internal constants — deliberately NOT config: safety semantics, not user
+ * preference (design ADR-0004). Clock and timers are injectable for tests. */
+export declare const BOUNDARY_QUIET_MS = 2000;
+export declare const PROBE_TIMEOUT_MS = 2000;
+export interface SessionBoundaryDeps {
+    /** THE single busy probe (PruneService.probeBusy), injected — never
+     * imported, so this module never depends on prune-service. */
+    probeBusy: (sessionID: string) => Promise<boolean | null>;
+    logger: Logger;
+    now?: () => number;
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (t: unknown) => void;
+}
+/**
+ * Classifies turn boundaries as AT-REST or relay-idle. Owns the ONLY
+ * per-session busy/idle event state machine (it absorbed the former
+ * SessionActivityTracker): exactly one entry per session, LRU-bounded.
+ *
+ * State model per session:
+ * - unknown            no evidence (fresh, TTL-decayed, or post-lifecycle); fail-open
+ * - busy               busy/retry evidence cached; TTL-decays to unknown
+ * - pending-rest       quiet window armed (BOUNDARY_QUIET_MS); busy/retry cancels
+ * - at-rest            rest confirmed; onAtRest fired once
+ *
+ * Idle handling: `pending-rest` + idle -> ignore (dual-publish second leg).
+ * `at-rest` + idle -> ignore on status-capable hosts (T1/T2: a real next turn
+ * is preceded by a busy/retry status that exits at-rest first). In degrade
+ * mode (T3: no status observation ever received) a legacy idle from at-rest
+ * RE-ARMS the window — every turn-end idle is a new boundary candidate.
+ */
+export declare class SessionBoundaryTracker {
+    private readonly sessions;
+    private readonly listeners;
+    private readonly probeBusy;
+    private readonly logger;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    constructor(deps: SessionBoundaryDeps);
+    /** Register an at-rest listener; listeners fire in registration order
+     * (1. deferred drain, 2. heuristic auto prune) and are individually
+     * error-isolated: a throw or rejection is warn-logged and never blocks
+     * later listeners nor escapes into the timer callback. */
+    onAtRest(listener: AtRestListener): void;
+    /** Primary input: `session.status` event payload status type. */
+    observeStatus(sessionID: string | undefined, statusType: unknown): void;
+    /** First-class input: legacy `session.idle`. Absorbed by dedup on hosts
+     * that dual-publish; the only boundary signal on status-less hosts (T3). */
+    observeLegacyIdle(sessionID: string | undefined): void;
+    /** Lifecycle: cancel any pending window and forget the session. */
+    observeDeleted(sessionID: string | undefined): void;
+    /** Lifecycle: compaction ended; reset to unknown so the next idle opens a
+     * fresh window. */
+    observeCompacted(sessionID: string | undefined): void;
+    /** Absorbed busy-evidence cache: `busy` decays to `unknown` after the TTL;
+     * the table is LRU-bounded (pending-rest/at-rest entries have no TTL exit
+     * and rely on the cap). */
+    state(sessionID: string): BoundaryPhase;
+    dispose(sessionID: string): void;
+    private observeIdle;
+    private armWindow;
+    private onWindowExpiry;
+    private transition;
+    private cancelWindow;
+    private fireAtRest;
+    private entry;
+    private refresh;
+    private evictIfNeeded;
+}
+/** Ceil a cooldown to whole seconds for user-facing copy. */
+export declare function retrySeconds(retryAfterMs: number): number;
+/**
+ * Resolves the session ID from a host event's properties. Most events carry
+ * `sessionID` directly, but some (e.g. `session.deleted`) only carry
+ * `info: Session`. Returns `undefined` when neither is a non-empty string.
+ */
+export declare function eventSessionID(properties?: Record<string, any>): string | undefined;
+//# sourceMappingURL=session-boundary.d.ts.map

package/dist/lib/session-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-boundary.d.ts","sourceRoot":"","sources":["../../lib/session-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;AAE3E;qEACqE;AACrE,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAEhE,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEhG;8EAC8E;AAC9E,eAAO,MAAM,iBAAiB,OAAQ,CAAA;AACtC,eAAO,MAAM,gBAAgB,OAAQ,CAAA;AAMrC,MAAM,WAAW,mBAAmB;IAChC;kEAC8D;IAC9D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACzD,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IAClD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAErC,IAAI,EAAE,mBAAmB;IASrC;;;8DAG0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIxC,iEAAiE;IACjE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAkBvE;gFAC4E;IAC5E,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKtD,mEAAmE;IACnE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IASnD;uBACmB;IACnB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgBrD;;+BAE2B;IAC3B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAavC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,SAAS;YAeH,cAAc;IAyC5B,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,aAAa;CAQxB;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,CAMnF"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "@lexwdex-org/opencode-dcp",
-    "version": "3.4.14",
+    "version": "3.5.0",
     "type": "module",
     "description": "Semantic pruning for OpenCode native context compaction",
     "main": "./dist/index.js",

package/dist/lib/activity.d.ts

@@ -1,22 +0,0 @@
-export type ActivityState = "busy" | "idle" | "unknown";
-/**
- * Tracks per-session busy/idle state from host events so compression can be
- * gated on real session activity instead of optimistic assumptions.
- *
- * State sources (in order of preference):
- * - `session.status` events carrying `{ status: { type: "busy" | "idle" } }`
- * - `session.idle` events (authoritative turn-boundary signal)
- *
- * Sessions with no observed events report "unknown"; callers decide what
- * fail-open means for their own trigger surface.
- */
-export declare class SessionActivityTracker {
-    private readonly sessions;
-    private readonly now;
-    constructor(now?: () => number);
-    observe(type: string, properties?: Record<string, any>): void;
-    state(sessionID: string): ActivityState;
-    dropSession(sessionID: string): void;
-    private set;
-}
-//# sourceMappingURL=activity.d.ts.map

package/dist/lib/activity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../lib/activity.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;AAYvD;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,GAAG,CAAC,EAAE,MAAM,MAAM;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAe7D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAOvC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpC,OAAO,CAAC,GAAG;CAUd"}